Files
nextcloud-docs/admin_manual/configuration_files/external_storage/amazons3.rst
2021-04-30 13:18:44 +02:00

39 lines
1.3 KiB
ReStructuredText

=========
Amazon S3
=========
To connect your Amazon S3 buckets to Nextcloud, you will need:
- S3 access key
- S3 secret key
- Bucket name
In the **Folder name** field enter a local folder name for your S3 mountpoint.
If this does not exist it will be created.
In the **Available for** field enter the users or groups who have permission to
access your S3 mount.
The ``Enable SSL`` checkbox enables HTTPS connections; using HTTPS is always
highly-recommended.
.. figure:: images/amazons3.png
:alt:
Optionally, you can override the hostname, port and region of your S3 server,
which is required for non-Amazon servers such as Ceph Object Gateway.
**Enable path style** is usually not required (and is, in fact, incompatible
with newer Amazon datacenters), but can be used with non-Amazon servers where
the DNS infrastructure cannot be controlled. Ordinarily, requests will be
made with ``http://bucket.hostname.domain/``, but with path style enabled,
requests are made with ``http://hostname.domain/bucket`` instead.
**Legacy authentication** is only required for S3 servers that only implement version 2 authentication,
by default version 4 authentication will be used.
See :doc:`../external_storage_configuration_gui` for additional mount
options and information.
See :doc:`auth_mechanisms` for more information on authentication schemes.