[[TOC()]]

= [wiki:help/en Cyberduck Help] / [wiki:help/en/howto Howto] / Nextcloud =

 [https://nextcloud.com/files/ Nextcloud Files] is an on-premise, open source file sync and share solution designed to be easy-to-use and highly secure.

== Connecting ==
=== Bookmark Configuration ===
 * Protocol: `WebDAV (HTTPS)`
 * Default Path: `/remote.php/webdav/`

=== Step-by-step Instructions ===
 * Connect to your NextCloud or OwnCloud instance in your web browser and log in.
 * Click on the option ''Settings'' in the lower left of the screen and copy the displayed WebDAV address.
 * Create a new [https://trac.cyberduck.io/wiki/help/en/howto/bookmarks bookmark]. In ''Mountain Duck'', click on the icon in the tray area or status bar and choose the option ''New Bookmark''.
 * Paste the previous copied WebDAV address into the server field and press tab. After that, the bookmark will be set to ''WebDAV (HTTPS)'' and split the WebDAV address into two parts – the server address and the path.

[[Image(NextCloud Bookmark Window.png)]]

 * Type your ''Username'' into the corresponding field and press ''Connect'' in the bookmark window if available or double click from the bookmark window.
 * Upon connecting, enter your password when requested in the login prompt.

=== 2-Factor Authentication ===
With 2-factor authentication enabled in NextCloud you will need to create an app password instead of your regular credentials. You should find it in ''Personal → App passwords''.

== Share Files ==
Create public shares for people who are not Nextcloud users using ''File → Share…''.

== Known Problems ==
=== 0-byte files ===
If you are running an Apache configuration make sure to disable `fastcgi` and `php-fpm`. Refer to our [wiki:help/en/howto/mount/issues/fastcgi|best practice for Nextcloud and ownCloud installations].

=== Slow listings for large folder structures ===
In order to retain timestamps for uploaded files we make use of custom WebDAV properties. In Nextcloud/ownCloud these properties are stored in a dedicated database table `oc_properties`. This table unfortunately does not define any index to speed up the lookup for these properties when doing a listing. The database always have to do a full scan to find the properties for the requested resources. For installations with a large number of files this can highly impact the response times for file listing. To overcome this issue you can create the following index:
{{{
CREATE INDEX properties_path_index ON oc_properties(userid, propertypath)
}}}

Also refer to the [https://github.com/nextcloud/server/issues/8962 issue] in GitHub.

== References ==
 * [https://docs.nextcloud.com/server/13/user_manual/files/access_webdav.html Accessing Nextcloud Files Using WebDAV]
 * [wiki:help/en/howto/mount/issues/fastcgi Zero byte file truncate issue with Nextcloud and ownCloud deployed with FastCGI]