Merge pull request #146 from j-ed/stable5

added description of custom mount configuration Web-GUI

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/