diff --git a/admin_manual/configuration/custom_mount_config_gui.rst b/admin_manual/configuration/custom_mount_config_gui.rst new file mode 100644 index 000000000..c592e2326 --- /dev/null +++ b/admin_manual/configuration/custom_mount_config_gui.rst @@ -0,0 +1,56 @@ +Custom Mount Configuration Web-GUI +================================== + +Since ownCloud 5.0 it is possible to mount external storage providers into +ownCloud's virtual file system. To add an external storage backend to your +ownCloud head to *Settings* -> *Admin* or *Personal*. As administrator you +can mount external storage for any group or user. Users are also allowed +to mount external storage for themselves if this setting has been enabled +by the administrator. + +.. figure:: ../images/custom_mount_config_gui-1.png + +At first the mount point has to be entered, this is the directory in ownCloud's +virtual file system, that the storage will be mounted to. Then the storage +backend has to be selected from the list of supported backends. As of writing +ownCloud currently supports the following storage backends: + +.. figure:: ../images/custom_mount_config_gui-2.png + +- Local file system (mount local storage that is outside ownCloud's data + directory) +- FTP (or FTPS) +- SFTP +- SMB +- WebDAV +- `Amazon S3`_ +- `Dropbox`_ +- `Google Drive`_ +- `OpenStack Swift`_ + +Please keep in mind, that users are not allowed to mount local file storage for +security purposes. + +.. figure:: ../images/custom_mount_config_gui-3.png +.. figure:: ../images/custom_mount_config_gui-4.png + +Once a backend has been selected, more configuration fields will appear. The +displayed configuration fields may vary depending on the selected storage backend. +For example, the FTP storage backend needs the following configuration details +to be entered: + +- **host**: the hostname of the ftp server +- **user**: the username used to login to the ftp server +- **password**: the password to login to the ftp server +- **secure**: whether to use ftps:// (FTP over TLS) to connect to the ftp + server instead of ftp:// (optional, defaults to false) +- **root**: the name of the folder inside the ftp server to mount (optional, + defaults to ‘/’) + +If *Dropbox* or *Google Drive* are chosen as storage backend an OAuth dialog will +be shown to automatically generate and fetch the required token information. + +.. _Amazon S3: http://aws.amazon.com/de/s3/ +.. _Dropbox: https://www.dropbox.com/ +.. _Google Drive: https://drive.google.com/start +.. _OpenStack Swift: http://openstack.org/projects/storage/ diff --git a/admin_manual/images/custom_mount_config_gui-1.png b/admin_manual/images/custom_mount_config_gui-1.png new file mode 100644 index 000000000..f10a99757 Binary files /dev/null and b/admin_manual/images/custom_mount_config_gui-1.png differ diff --git a/admin_manual/images/custom_mount_config_gui-2.png b/admin_manual/images/custom_mount_config_gui-2.png new file mode 100644 index 000000000..2d07544be Binary files /dev/null and b/admin_manual/images/custom_mount_config_gui-2.png differ diff --git a/admin_manual/images/custom_mount_config_gui-3.png b/admin_manual/images/custom_mount_config_gui-3.png new file mode 100644 index 000000000..0bccea9ae Binary files /dev/null and b/admin_manual/images/custom_mount_config_gui-3.png differ diff --git a/admin_manual/images/custom_mount_config_gui-4.png b/admin_manual/images/custom_mount_config_gui-4.png new file mode 100644 index 000000000..e6ea08091 Binary files /dev/null and b/admin_manual/images/custom_mount_config_gui-4.png differ