========
FTP/FTPS
========

If you want to mount an FTP Storage, please install the `FTP Storage Support`_ app from the ownCloud Marketplace.

.. figure:: ../../../images/ftp_storage_support.png
   :alt: The ownCloud FTP Storage Support App.


To connect to an FTP server, you will need:

* A folder name for your local mountpoint; the folder will be created if it 
  does not exist
* The URL of the FTP server
* Port number (default: 21)
* Username and password to access the resource
* Remote Subfolder, the FTP directory to mount in ownCloud. ownCloud defaults 
  to the root directory. If you specify a subfolder you must leave 
  off the leading slash. For example, ``public_html/images``
  
Your new mountpoint is available to all users by default, and you may restrict 
access by entering specific users or groups in the **Available for** field.  

Optionally, ownCloud can use FTPS (FTP over SSL) by checking **Secure ftps://**. 
This requires additional configuration with your root certificate if the FTP 
server uses a self-signed certificate (See :doc:`../../server/import_ssl_cert`).

.. figure:: images/ftp.png
   :alt: ownCloud GUI FTP configuration. 

.. note:: The external storage ``FTP/FTPS`` needs the ``allow_url_fopen`` PHP
   setting to be set to ``1``. When having connection problems make sure that it 
   is not set to ``0`` in your ``php.ini``. See :ref:`label-phpinfo` to learn 
   how to find the right ``php.ini`` file to edit.

See :doc:`../external_storage_configuration_gui` for additional mount 
options and information.

FTP uses the password authentication scheme; see :doc:`auth_mechanisms` for 
more information on authentication schemes.
.. Links

.. _FTP Storage Support: https://marketplace.owncloud.com/apps/files_external_ftp
