?i»?
Current Path : /home/scgforma/www/cloud/core/doc/admin/configuration_files/ |
Current File : /home/scgforma/www/cloud/core/doc/admin/configuration_files/external_storage_configuration_gui.html |
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>Configuring External Storage (GUI) — Nextcloud 13 Administration Manual 13 documentation</title> <link rel="stylesheet" href="../_static/" type="text/css" /> <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> <link rel="stylesheet" href="../_static/main.min.css" type="text/css" /> <link rel="stylesheet" href="../_static/styles.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '../', VERSION: '13', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true }; </script> <script type="text/javascript" src="../_static/jquery.js"></script> <script type="text/javascript" src="../_static/underscore.js"></script> <script type="text/javascript" src="../_static/doctools.js"></script> <script type="text/javascript" src="../_static/js/jquery-1.11.0.min.js"></script> <script type="text/javascript" src="../_static/js/jquery-fix.js"></script> <script type="text/javascript" src="../_static/bootstrap-3.1.0/js/bootstrap.min.js"></script> <script type="text/javascript" src="../_static/bootstrap-sphinx.js"></script> <link rel="top" title="Nextcloud 13 Administration Manual 13 documentation" href="../contents.html" /> <link rel="up" title="File sharing and management" href="index.html" /> <link rel="next" title="Amazon S3" href="external_storage/amazons3.html" /> <link rel="prev" title="Providing default files" href="default_files_configuration.html" /> <meta charset='utf-8'> <meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'> <meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'> <meta name="apple-mobile-web-app-capable" content="yes"> <meta name="theme-color" content="#1d2d44"> </head> <body role="document"> <div class="wrap container not-front"> <div class="content row"> <main class="main"> <div class="row"> <div class="col-md-3"> <div class="sidebar"> <h1>Nextcloud 13 Administration Manual</h1> <div class="sidebar-search"> <form class="headersearch" action="../search.html" method="get"> <input type="text" value="" name="q" id="q" class="form-control" /> <button class="btn btn-default" type="submit" id="searchsubmit">Search</button> </form> </div> <div class="menu-support-container"> <ul id="menu-support" class="menu"> <ul> <li><a href="../contents.html">Table of Contents</a></li> </ul> <ul class="current"> <li class="toctree-l1"><a class="reference internal" href="../index.html">Introduction</a></li> <li class="toctree-l1"><a class="reference internal" href="../release_notes.html">Release notes</a></li> <li class="toctree-l1"><a class="reference internal" href="../installation/index.html">Installation</a></li> <li class="toctree-l1"><a class="reference internal" href="../configuration_server/index.html">Server configuration</a></li> <li class="toctree-l1"><a class="reference internal" href="../configuration_user/index.html">User management</a></li> <li class="toctree-l1 current"><a class="reference internal" href="index.html">File sharing and management</a><ul class="current"> <li class="toctree-l2"><a class="reference internal" href="file_sharing_configuration.html">File Sharing</a></li> <li class="toctree-l2"><a class="reference internal" href="federated_cloud_sharing_configuration.html">Configuring Federation Sharing</a></li> <li class="toctree-l2"><a class="reference internal" href="big_file_upload_configuration.html">Uploading big files > 512MB</a></li> <li class="toctree-l2"><a class="reference internal" href="default_files_configuration.html">Providing default files</a></li> <li class="toctree-l2 current"><a class="current reference internal" href="">Configuring External Storage (GUI)</a><ul> <li class="toctree-l3"><a class="reference internal" href="#enabling-external-storage-support">Enabling External Storage Support</a></li> <li class="toctree-l3"><a class="reference internal" href="#storage-configuration">Storage configuration</a></li> <li class="toctree-l3"><a class="reference internal" href="#user-and-group-permissions">User and group permissions</a></li> <li class="toctree-l3"><a class="reference internal" href="#mount-options">Mount options</a></li> <li class="toctree-l3"><a class="reference internal" href="#using-self-signed-certificates">Using self-signed certificates</a></li> <li class="toctree-l3"><a class="reference internal" href="#available-storage-backends">Available storage backends</a></li> <li class="toctree-l3"><a class="reference internal" href="#allow-users-to-mount-external-storage">Allow users to mount external Storage</a></li> <li class="toctree-l3"><a class="reference internal" href="#adding-files-to-external-storages">Adding files to external storages</a></li> </ul> </li> <li class="toctree-l2"><a class="reference internal" href="external_storage_configuration.html">Configuring External Storage (configuration file)</a></li> <li class="toctree-l2"><a class="reference internal" href="external_storage/auth_mechanisms.html">External Storage authentication mechanisms</a></li> <li class="toctree-l2"><a class="reference internal" href="encryption_configuration.html">Encryption configuration</a></li> <li class="toctree-l2"><a class="reference internal" href="files_locking_transactional.html">Transactional file locking</a></li> <li class="toctree-l2"><a class="reference internal" href="previews_configuration.html">Previews configuration</a></li> <li class="toctree-l2"><a class="reference internal" href="file_versioning.html">Controlling file versions and aging</a></li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="../file_workflows/index.html">File workflows</a></li> <li class="toctree-l1"><a class="reference internal" href="../configuration_database/index.html">Database configuration</a></li> <li class="toctree-l1"><a class="reference internal" href="../configuration_mimetypes/index.html">Mimetypes management</a></li> <li class="toctree-l1"><a class="reference internal" href="../maintenance/index.html">Maintenance</a></li> <li class="toctree-l1"><a class="reference internal" href="../issues/index.html">Issues and troubleshooting</a></li> </ul> </ul> </div> </div> </div> <div class="col-md-9"> <div class="page-content"> <ul class="prevnext-title list-unstyled list-inline"> <li class="prev"> <a href="default_files_configuration.html" title="Previous Chapter: Providing default files"><span class="glyphicon glyphicon-chevron-left visible-sm"></span><span class="hidden-sm">« Providing default files</span> </a> </li> <li class="next"> <a href="external_storage/amazons3.html" title="Next Chapter: Amazon S3"><span class="glyphicon glyphicon-chevron-right visible-sm"></span><span class="hidden-sm">Amazon S3 »</span> </a> </li> </ul> <div class="section" id="configuring-external-storage-gui"> <h1>Configuring External Storage (GUI)<a class="headerlink" href="#configuring-external-storage-gui" title="Permalink to this headline">¶</a></h1> <p>The External Storage Support application enables you to mount external storage services and devices as secondary Nextcloud storage devices. You may also allow users to mount their own external storage services.</p> <p>Nextcloud 9.0 introduces a new set of <a class="reference internal" href="../configuration_server/occ_command.html#files-external-label"><span>occ commands for managing external storage</span></a>.</p> <p>Also new in 9.0 is an option for the Nextcloud admin to enable or disable sharing on individual external mountpoints (see <a class="reference internal" href="#external-storage-mount-options-label"><span>Mount options</span></a>). Sharing on such mountpoints is disabled by default.</p> <div class="section" id="enabling-external-storage-support"> <h2>Enabling External Storage Support<a class="headerlink" href="#enabling-external-storage-support" title="Permalink to this headline">¶</a></h2> <div class="admonition warning"> <p class="first admonition-title">Warning</p> <p class="last">Enabling this app will disable the <strong>Stay logged in</strong> checkbox on the login page.</p> </div> <p>The External storage support application is enabled on your Apps page.</p> <div class="figure"> <img alt="Enable external storage on your Apps page." src="../_images/enable-app.png" /> </div> </div> <div class="section" id="storage-configuration"> <h2>Storage configuration<a class="headerlink" href="#storage-configuration" title="Permalink to this headline">¶</a></h2> <p>To create a new external storage mount, select an available backend from the dropdown <strong>Add storage</strong>. Each backend has different required options, which are configured in the configuration fields.</p> <div class="figure"> <img alt="../_images/add_storage.png" src="../_images/add_storage.png" /> </div> <p>Each backend may also accept multiple authentication methods. These are selected with the dropdown under <strong>Authentication</strong>. Different backends support different authentication mechanisms; some specific to the backend, others are more generic. See <a class="reference internal" href="external_storage/auth_mechanisms.html"><em>External Storage authentication mechanisms</em></a> for more detailed information.</p> <p>When you select an authentication mechanism, the configuration fields change as appropriate for the mechanism. The SFTP backend, for one example, supports <strong>username and password</strong>, <strong>Log-in credentials, save in session</strong>, and <strong>RSA public key</strong>.</p> <div class="figure"> <img alt="An SFTP configuration example." src="../_images/auth_mechanism.png" /> </div> <p>Required fields are marked with a red border. When all required fields are filled, the storage is automatically saved. A green dot next to the storage row indicates the storage is ready for use. A red or yellow icon indicates that Nextcloud could not connect to the external storage, so you need to re-check your configuration and network availability.</p> <p>If there is an error on the storage, it will be marked as unavailable for ten minutes. To re-check it, click the colored icon or reload your Admin page.</p> </div> <div class="section" id="user-and-group-permissions"> <h2>User and group permissions<a class="headerlink" href="#user-and-group-permissions" title="Permalink to this headline">¶</a></h2> <p>A storage configured in a user’s Personal settings is available only to the user that created it. A storage configured in the Admin settings is available to all users by default, and it can be restricted to specific users and groups in the <strong>Available for</strong> field.</p> <div class="figure"> <img alt="User and groups selector" src="../_images/applicable.png" /> </div> </div> <div class="section" id="mount-options"> <span id="external-storage-mount-options-label"></span><h2>Mount options<a class="headerlink" href="#mount-options" title="Permalink to this headline">¶</a></h2> <p>Hover your cursor to the right of any storage configuration to expose the settings button and trashcan. Click the trashcan to delete the mountpoint. The settings button allows you to configure each storage mount individually with the following options:</p> <ul class="simple"> <li>Encryption</li> <li>Previews</li> <li>Enable Sharing</li> <li>Filesystem check frequency (Never, Once per direct access)</li> </ul> <p>The <strong>Encryption</strong> checkbox is visible only when the Encryption app is enabled.</p> <p><strong>Enable Sharing</strong> allows the Nextcloud admin to enable or disable sharing on individual mountpoints. When sharing is disabled the shares are retained internally, so that you can re-enable sharing and the previous shares become available again. Sharing is disabled by default.</p> <div class="figure"> <img alt="Additional mount options exposed on mouseover." src="../_images/mount_options.png" /> </div> </div> <div class="section" id="using-self-signed-certificates"> <h2>Using self-signed certificates<a class="headerlink" href="#using-self-signed-certificates" title="Permalink to this headline">¶</a></h2> <p>When using self-signed certificates for external storage mounts the certificate must be imported into the personal settings of the user. Please refer to <a class="reference external" href="http://ownclouden.blogspot.de/2014/11/owncloud-https-external-mount.html">Nextcloud HTTPS External Mount</a> for more information.</p> </div> <div class="section" id="available-storage-backends"> <h2>Available storage backends<a class="headerlink" href="#available-storage-backends" title="Permalink to this headline">¶</a></h2> <p>The following backends are provided by the external storages app. Other apps may provide their own backends, which are not listed here. Google Drive and Dropbox were moved to external apps which are still in development (Github-Repos for <a class="reference external" href="https://github.com/owncloud/files_external_gdrive">Google Drive</a> and <a class="reference external" href="https://github.com/icewind1991/files_external_dropbox">Dropbox</a>).</p> <div class="toctree-wrapper compound"> <ul> <li class="toctree-l1"><a class="reference internal" href="external_storage/amazons3.html">Amazon S3</a></li> <li class="toctree-l1"><a class="reference internal" href="external_storage/ftp.html">FTP/FTPS</a></li> <li class="toctree-l1"><a class="reference internal" href="external_storage/local.html">Local</a></li> <li class="toctree-l1"><a class="reference internal" href="external_storage/nextcloud.html">Nextcloud</a></li> <li class="toctree-l1"><a class="reference internal" href="external_storage/openstack.html">OpenStack Object Storage</a></li> <li class="toctree-l1"><a class="reference internal" href="external_storage/sftp.html">SFTP</a></li> <li class="toctree-l1"><a class="reference internal" href="external_storage/smb.html">SMB/CIFS</a></li> <li class="toctree-l1"><a class="reference internal" href="external_storage/webdav.html">WebDAV</a></li> </ul> </div> <div class="admonition note"> <p class="first admonition-title">Note</p> <p class="last">A non-blocking or correctly configured SELinux setup is needed for these backends to work. Please refer to the <a class="reference internal" href="../installation/selinux_configuration.html#selinux-config-label"><span>SELinux configuration</span></a>.</p> </div> </div> <div class="section" id="allow-users-to-mount-external-storage"> <h2>Allow users to mount external Storage<a class="headerlink" href="#allow-users-to-mount-external-storage" title="Permalink to this headline">¶</a></h2> <p>Check <strong>Enable User External Storage</strong> to allow your users to mount their own external storage services, and check the backends you want to allow. Beware, as this allows a user to make potentially arbitrary connections to other services on your network!</p> <div class="figure"> <img alt="Checkboxes to allow users to mount external storage services." src="../_images/user_mounts.png" /> </div> </div> <div class="section" id="adding-files-to-external-storages"> <h2>Adding files to external storages<a class="headerlink" href="#adding-files-to-external-storages" title="Permalink to this headline">¶</a></h2> <p>We recommend configuring the background job <strong>Webcron</strong> or <strong>Cron</strong> (see <a class="reference internal" href="../configuration_server/background_jobs_configuration.html"><em>Defining background jobs</em></a>) to enable Nextcloud to automatically detect files added to your external storages.</p> <p>Nextcloud may not always be able to find out what has been changed remotely (files changed without going through Nextcloud), especially when it’s very deep in the folder hierarchy of the external storage.</p> <p>You might need to setup a cron job that runs <code class="docutils literal"><span class="pre">sudo</span> <span class="pre">-u</span> <span class="pre">www-data</span> <span class="pre">php</span> <span class="pre">occ</span> <span class="pre">files:scan</span> <span class="pre">--all</span></code> (or replace “–all” with the user name, see also <a class="reference internal" href="../configuration_server/occ_command.html"><em>Using the occ command</em></a>) to trigger a rescan of the user’s files periodically (for example every 15 minutes), which includes the mounted external storage.</p> </div> </div> <ul class="prevnext-title list-unstyled list-inline"> <li class="prev"> <a href="default_files_configuration.html" title="Previous Chapter: Providing default files"><span class="glyphicon glyphicon-chevron-left visible-sm"></span><span class="hidden-sm">« Providing default files</span> </a> </li> <li class="next"> <a href="external_storage/amazons3.html" title="Next Chapter: Amazon S3"><span class="glyphicon glyphicon-chevron-right visible-sm"></span><span class="hidden-sm">Amazon S3 »</span> </a> </li> </ul> </div> </div> </div> </main> </div> </div> </body> </html>