Tizhout restroù Nextcloud en ur implijout WebDAV
Nextcloud fully supports the WebDAV protocol, and you can connect and synchronize with Nextcloud Files over WebDAV. In this chapter, you will learn how to connect Linux, macOS, Windows, and mobile devices to your Nextcloud server.
WebDAV stands for Distributed Authoring and Versioning. It is an HTTP extension that makes it easy to create, read, and edit files hosted on remote Web servers. With a WebDAV client, you can access your Nextcloud Files (including shares) on Linux, macOS and Windows in a similar way as any remote network share, and stay synchronized.
Before we get into configuring WebDAV, let's take a quick look at the recommended way of connecting client devices to Nextcloud.
Official Nextcloud desktop and mobile clients
The recommended way to synchronize a computer with a Nextcloud server is by using the official Nextcloud sync clients. You can configure the client to save files in any local directory and you can choose which directories on the Nextcloud server to sync with. The client displays the current connection status and logs all activity, so you always know which remote files have been downloaded to your PC and you can verify that files created and updated on your local PC are properly synchronized with the server.
The recommended way to synchronize Android and Apple iOS devices is by using the official Nextcloud mobile apps.
To connect the official Nextcloud apps to a Nextcloud server use the same URL you use to access Nextcloud from your web browser - e.g.:
https://cloud.example.com
https://example.com/nextcloud (if Nextcloud is installed in a subdirectory called "nextcloud")
Third-party WebDAV clients
If you prefer, you may also connect your computer to your Nextcloud server by using any third-party client that supports the WebDAV protocol (including what may be built into your operating system).
You can also use third-party WebDAV capable apps to connect your mobile device to Nextcloud.
When using third-party clients, keep in mind that they may not be optimized for use with Nextcloud or implement capabilities you consider important to your use case.
Mobile clients that Nextcloud community members have reported using include:
The URL to use when configuring third-party apps to connect to Nextcloud is a bit lengthier than the one for official clients:
https://cloud.example.com/remote.php/dav/files/USERNAME/
https://example.com/nextcloud/remote.php/dav/files/USERNAME/ (if Nextcloud is installed in a subdirectory called "nextcloud")
Note
When using a third-party WebDAV client (including your operating system's built-in client), you should use an application password for login rather than your regular password. In addition improved security, this increases performance significantly. To configure an application password, log into the Nextcloud Web interface, click on the avatar in the top right and choose Personal settings. Then choose Security in the left sidebar and scroll to the very bottom. There you can create an app password (which can also be revoked in the future without changing your main user password).
Note
In the following examples, you should replace example.com/nextcloud with the URL of your Nextcloud server (omit the directory part if the installation is in the root of your domain), and USERNAME with the username of the connecting user.
See the WebDAV URL (bottom left in settings) on your Nextcloud.
Tizhout ar restr en ur implijout Linux
Posupl eo deoc'h tizhout restroù gant ur reizhiad korvoiñ Linux en ur implijout an doare-mañ.
Merour restroù Nautilus
When you configure your Nextcloud account in the GNOME Control Center, your files will automatically be mounted by Nautilus as a WebDAV share, unless you deselect file access.
Posupl eo deoc'h staliañ ho restroù Nextcloud gant an dorn. Implijit ar protokol 'davs://` evit kenstagañ ar merour restroù Nautilus d'ho rannadennoù Nextcloud
davs://example.com/nextcloud/remote.php/dav/files/USERNAME/
Note
If your server connection is not HTTPS-secured, use dav://
instead
of davs://
:
Note
The same method works for other file managers that use GVFS, such as MATE's Caja and Cinnamon's Nemo.
Tizhout restroù gant KDE pe Dolphin file manager
Evit tizhout ho restroù Nextcloud en ur implijout Dolphin file manager e KDE, implijit ar protokol webdav://
webdav://example.com/nextcloud/remote.php/dav/files/USERNAME/
Posupl eo deoc'h krouiñ ul liamm peurbadel d'ho servijour Nextcloud :
Open Dolphin and click "Network" in the left-hand "Places" column.
Pouezit war ar skeudenn anvet Ouzhpennañ un teuliad kenrouedad. An diviz a zlefe dont war wel gant WebDAV dija choazet.
Ma n'eo ket bet choazet WebDAV, choazit anezhañ.
Pouezit war Da heul
Lakait an dibarzhioù-mañ :
Name: the name you want to see in the Places bookmark, for example, Nextcloud.
User: the Nextcloud username you used to log in, for example, admin.
Server: the Nextcloud domain name, for example, example.com (without http:// before or directories afterwards).
Teuliad - Lakait an hent
nextcloud/remote.php/dav/files/USERNAME/
.
(Optional) Check the "Create icon" checkbox for a bookmark to appear in the Places column.
(Diret) Roit ur stumm ispisial pe ur sertikad SSL er checkbox "Port & Encrypted"
Krouiñ sternioù WebDAV war al linenn urzh Linux
Posupl eo deoc'h krouiñ sternioù diouzh linennoù urzh Linux. Aesaat a ra an tizhout Nextcloud m'ho peus c'hoant tizhout anezhañ evel n'eus forzh peseurt sistem-restroù sternioù pell. Ar skouerioù dindan a ziskouezo penaos krouiñ sternioù ha lakaat anezho en un doare otomatik bep wech ez it war hoc'h urzhiataer Linux.
Staliañ ar sturier sistem-restroù "davfs2" WebDAV, a aotre ac'hanoc'h da lakaat rannadennoù WebDAV evel n'eus forzh peseurt sistem-restroù pell. Implijit al linenn urzh evit staliañ Debian/Ubuntu:
apt-get install davfs2
Implijit al linenn urzh evit staliañ CentOS, Fedora, hag openSUSE:
yum install davfs2
Ouzhpennit ac'hanoc'h d'ar strollad "davfs2":
usermod -aG davfs2 <username>
Then create a
nextcloud
directory in your home directory for the mount point, and.davfs2/
for your personal configuration file:mkdir ~/nextcloud mkdir ~/.davfs2
Eilit "/etc/davfs2/secrets" da "~/.davfs2":
cp /etc/davfs2/secrets ~/.davfs2/secrets
Lakait ac'hanoc'h evel perc'henner ha lakait an aotre lenn-skrivañ d'ar perc'henner nemetken:
chown <linux_username>:<linux_username> ~/.davfs2/secrets chmod 600 ~/.davfs2/secrets
Ouzhpennit ho hennadoù mont-tre Nextcloud e fin ar restr "sekredoù", en ur implijout ho URL servijour Nextcloud ha ho anv implijour ha ger-tremen Nextcloud:
https://example.com/nextcloud/remote.php/dav/files/USERNAME/ <username> <password> or $PathToMountPoint $USERNAME $PASSWORD for example /home/user/nextcloud john 1234
Ouzhpennañ an titouroù stern da
/etc/fstab
:https://example.com/nextcloud/remote.php/dav/files/USERNAME/ /home/<linux_username>/nextcloud davfs user,rw,auto 0 0
Amprouit e ves stag ha dileset en ur implijout al linenn urzh-mañ. Ma eo bet staliet mat ne vo ket ezhomm eus un aotree gwrizienn:
mount ~/nextcloud
Posupl a vo deoc'h distagañ anezhañ ivez:
umount ~/nextcloud
Bewech e hit tre war ho sistem Linux e zlefe ho rannadennoù Nextcloud en em stagañ en un doare otomatek dre WebDAV en ho teuliad ~/nextcloud
. Ma eo gweloc'h deoc'h stagañ anezhañ gant an dorn, cheñchit "auto" da "noauto" e /etc/fstab
.
Kudennoù anavezet
Kudenn
N'eo ket implijapl an dra evit ar poent
Diskoulm
Ma ho peus kudennoù pa vez krouet ur restr en teuliad, cheñchiit /etc/davfs2/davfs2.conf
hag ouzhpennit:
use_locks 0
Kudenn
Diwall ar sertifikad
Diskoulm
Ma implijit ur sertifikad sinet-e-unan, ur gemennadenn diwall ho po. Evit cheñch se, ret eo deoc'h stummañ "davfs2" evit anavezout ar sertifikad. Eilit mycertificate.pem
da /etc/davfs2/certs/
. Embannit goude /etc/davfs2/davfs2.conf
ha dizisplegit al linenn servercert
. Ouzhpennit hent ar sertifikad evel er skouer:
servercert /etc/davfs2/certs/mycertificate.pem
O tizhout restroù en ur implijout macOS
Note
The macOS Finder suffers from a series of implementation problems and should only be used if the Nextcloud server runs on Apache and mod_php, or Nginx 1.3.8+. Alternative macOS-compatible clients capable of accessing WebDAV shares include open source apps like Cyberduck (see instructions here) and Filezilla. Commercial clients include Mountain Duck, Forklift, Transmit, and Commander One.
Evit tizhout restroù dre macOS Finder :
From the Finder's top menu bar, choose Go > Connect to Server…:
When the Connect to Server… window opens, enter your Nextcloud server's WebDAV address in the Server Address: field, i.e.:
https://cloud.YOURDOMAIN.com/remote.php/dav/files/USERNAME/
Pouezit war Kenstagañ. Ho servijour WebDAV a vo gwelet war ar burev evel ur gantenn rannet.
Tizhout restroù en ur implijout Microsoft Windows
If you use the native Windows implementation of WebDAV, you can map Nextcloud to a new drive using Windows Explorer. Mapping to a drive enables you to browse files stored on a Nextcloud server the way you would browse files stored in a mapped network drive.
Evit implij ar perzh-mañ eo ret kaout ur genstagadenn gant ar c'henrouedad. Ma ho peus c'hoant enrollañ ho restroù hep bezañ kenstaget, implijit ar c'hliant burev evit kempredañ pep restr war ho Nextcloud en un teuliad pe vuioc'h eus ho kantenn diabarzh.
Note
Windows 10 now defaults to allow Basic Authentication if HTTPS is enabled before mapping your drive.
On older versions of Windows, you must permit the use of Basic Authentication in the Windows Registry:
launch
regedit
and navigate toHKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters
.Create or edit the
BasicAuthLevel
(Windows Vista, 7 and 8), orUseBasicAuth
(Windows XP and Windows Server 2003),DWORD
value and set its value data to1
for SSL connections. A value of0
means that Basic Authentication is disabled, and a value of2
allows both SSL and non-SSL connections (not recommended).Then exit Registry Editor, and restart the computer.
Kenstagit ul lenner rouedad gant al linenn urzh
Ar skouer da heul a ziskouez penaos kenstagañ ul lenner rouedad gant ul linnen urzh. Evit kenstagañ al lenner :
Digeriñ an dermenell e Windows.
Lakit al linenn urzh-mañ er c'hinnig urzh evit kenstagañ gant al lenner Z
net use Z: https://<drive_path>/remote.php/dav/files/USERNAME/ /user:youruser yourpassword
with <drive_path> as the URL to your Nextcloud server. For example:
net use Z: https://example.com/nextcloud/remote.php/dav/files/USERNAME/ /user:youruser yourpassword
Kenstaget eo restroù ho kont Nextcloud d'al lenner Z.
Note
If you get the following error
System error 67 has occurred. The network name cannot be found.
,
open the Services app and make sure that the WebClient
service is running and started automatically at startup.
Note
Though not recommended, you can also mount the Nextcloud server using HTTP, leaving the connection unencrypted.
If you plan to use HTTP connections on devices while in a public place, we strongly recommend using a VPN tunnel to provide the necessary security.
Un doare all evit skrivañ al linenn urzh
net use Z: \\example.com@ssl\nextcloud\remote.php\dav /user:youruser
yourpassword
Kenstagañ al lenner gant Windows Explorer
To map a drive using Microsoft Windows Explorer:
Open Windows Explorer on your MS Windows computer.
Right-click on Computer entry and select Map network drive… from the drop-down menu.
Choazit ul lenner kenrouedad diabarzh ho peus c'hoant kenstagañ gant ho Nextcloud.
Lakait chomlec'h ho azgoulenn Nextcloud, heuliet gant /remote.php/dav/files/USERNAME/.
Da skouer :
https://example.com/nextcloud/remote.php/dav/files/USERNAME/
Note
For SSL-protected servers, check Reconnect at sign-in to ensure that the mapping is persistent upon subsequent reboots. If you want to connect to the Nextcloud server as a different user, check Connect using different credentials.
Pouezit war ar bouton "Echuiñ".
Kenstagañ a ra Windows Explorer al lenner kenrouedad, oc'h aotreañ tizhout an azgoulenn Nextcloud.
Tizhout ar restr en ur implijout Cyberduck
Cyberduck is an open source FTP, SFTP, WebDAV, OpenStack Swift, and Amazon S3 browser designed for file transfers on macOS and Windows.
Note
Ar skouer-mañ a implij Cyberduck stumm 4.2.1
Evit implijout Cyberduck :
Specify a server without any leading protocol information.
For example:
example.com
Specify the appropriate port.
The port you choose depends on whether or not your Nextcloud server supports SSL. Cyberduck requires that you select a different connection type if you plan to use SSL.
- For example:
80
for unencrypted WebDAV443
for secure WebDAV (HTTPS/SSL)
Use the 'More Options' drop-down menu to add the rest of your WebDAV URL into the 'Path' field.
For example:
remote.php/dav/files/USERNAME/
Aotreañ a ra bremañ Cyberduck da tizhout restroù war ar servijour Nextcloud.
Kudennoù anavezhet
Kudenn
Ne genstag ket Windows en ur implijout HTTPS.
Diskoulm 1
Ar c'hliant WebDAV Windows na zoug marteze ket Server Name Indication (SNI) war genstagadurioù sifret. Ma 'z eus ur gudenn en ur stagañ un azgoulenn Nextloud SSL sifret, galvit ho pourvezer evit lakaat ur chomlec'h IP resis evit ho servijour diazezet war SSL.
Diskoulm 2
The Windows WebDAV Client might not support TLSv1.1 and TLSv1.2 connections. If you have restricted your server config to only provide TLSv1.1 and above the connection to your server might fail. Please refer to the WinHTTP documentation for further information.
Kudenn
Ar gemennadenn fazi-mañ ho peus resevet : Error 0x800700DF : Re vras eo ar restr ha n'eo ket posupl enrollañ anezhañ.
Diskoulm
Windows limits the maximum size a file transferred from or to a WebDAV share may have. You can increase the value FileSizeLimitInBytes in HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters by clicking on Modify.
Evit brasaat ar vevenn betek 4GB, choazit Decimal, lakait 4294967295, hag adlañsit Windows hag ar servij WebClient.
Kudenn
Adding a WebDAV drive on Windows via the above described steps does not display the correct size of in Nextcloud available space and instead shows the size of the C: drive with its available space.
Answer
Unfortunately is this a limitation of WebDAV itself, because it does not provide a way for the client to get the available free space from the server. Windows automatically falls back to show the size of the C: drive with its available space instead. So unfortunately there is no real solution to this problem.
Kudenn
Tizhout ho restroù Microsoft Office dre WebDAV c'hwitet.
Diskoulm
Kudennoù anavezet hag o ziskoulmoù a vez kavet er pennad KB2123563 .
Kudenn
Cannot map Nextcloud as a WebDAV drive in Windows using a self-signed certificate.
Diskoulm
Access to your Nextcloud instance via your favorite Web browser.
Klikit betek m'ho po fazi ar sertifikad el linenn stad ho furcher.
View the certificate, then from the Details tab, select 'Copy to File'.
Save the file to your desktop with an arbitrary name, for example
myNextcloud.pem
.Go to Start menu > Run, type MMC, and click 'OK' to open Microsoft Management Console.
Go to File > Add/Remove Snap-In.
Select Certificates, Click 'Add', choose 'My User Account', then 'Finish', and finally 'OK'.
Kit betek Trust Root Certification Authorities, Certificates.
Right-Click Certificate, Select All Tasks, and Import.
Select the saved certificate from the Desktop.
Select Place all Certificates in the following Store, and click Browse.
Check the Box that says Show Physical Stores, expand out Trusted Root Certification Authorities, select Local Computer there, click 'OK', and Complete the Import.
Check the list to make sure the certificate shows up. You will probably need to Refresh before you see it.
Exit MMC.
For Firefox users:
Launch your browser, go to Application menu > History > Clear recent history...
Select 'Everything' in the 'Time range to clear' dropdown menu
Select the 'Active Logins' check box
Click the 'Clear now' button
Close the browser, then re-open and test.
For Chrome-based browsers (Chrome, Chromium, Microsoft Edge) users:
Open Windows Control Panel, navigate down to Internet Options
In the Content tab, click the Clear SSL State button.
Close the browser, then re-open and test.
Tizhout ar restr en ur implijout cURL
Since WebDAV is an extension of HTTP, cURL can be used to script file operations.
Note
Settings → Administration → Sharing → Allow users on this server to send shares to other servers.
If this option is disabled, the option --header "X-Requested-With: XMLHttpRequest"
needs to be passed to cURL.
Evit krouiñ un teuliad gant an deiziat evel anv :
$ curl -u user:pass -X MKCOL "https://example.com/nextcloud/remote.php/dav/files/USERNAME/$(date '+%d-%b-%Y')"
Evit pellkas ur restr "error.log" en teuliad-mañ :
$ curl -u user:pass -T error.log "https://example.com/nextcloud/remote.php/dav/files/USERNAME/$(date '+%d-%b-%Y')/error.log"
Evit diblasañ ur restr :
$ curl -u user:pass -X MOVE --header 'Destination: https://example.com/nextcloud/remote.php/dav/files/USERNAME/target.jpg' https://example.com/nextcloud/remote.php/dav/files/USERNAME/source.jpg
Evit kaout perzhioù ar restroù en teuliad gwrizienn :
$ curl -X PROPFIND -H "Depth: 1" -u user:pass https://example.com/nextcloud/remote.php/dav/files/USERNAME/ | xml_pp
<?xml version="1.0" encoding="utf-8"?>
<d:multistatus xmlns:d="DAV:" xmlns:oc="http://nextcloud.org/ns" xmlns:s="http://sabredav.org/ns">
<d:response>
<d:href>/nextcloud/remote.php/dav/files/USERNAME/</d:href>
<d:propstat>
<d:prop>
<d:getlastmodified>Tue, 13 Oct 2015 17:07:45 GMT</d:getlastmodified>
<d:resourcetype>
<d:collection/>
</d:resourcetype>
<d:quota-used-bytes>163</d:quota-used-bytes>
<d:quota-available-bytes>11802275840</d:quota-available-bytes>
<d:getetag>"561d3a6139d05"</d:getetag>
</d:prop>
<d:status>HTTP/1.1 200 OK</d:status>
</d:propstat>
</d:response>
<d:response>
<d:href>/nextcloud/remote.php/dav/files/USERNAME/welcome.txt</d:href>
<d:propstat>
<d:prop>
<d:getlastmodified>Tue, 13 Oct 2015 17:07:35 GMT</d:getlastmodified>
<d:getcontentlength>163</d:getcontentlength>
<d:resourcetype/>
<d:getetag>"47465fae667b2d0fee154f5e17d1f0f1"</d:getetag>
<d:getcontenttype>text/plain</d:getcontenttype>
</d:prop>
<d:status>HTTP/1.1 200 OK</d:status>
</d:propstat>
</d:response>
</d:multistatus>
Accessing files using WinSCP
WinSCP is an open source free SFTP, FTP, WebDAV, S3, and SCP client for Windows. Its main function is file transfer between a local and a remote computer. Beyond this, WinSCP offers scripting and basic file management functionality.
You can download the portable version of WinSCP and run it on Linux through Wine.
To run WinSCP on Linux, download wine through your distribution's package manager, then run it with the command: wine WinSCP.exe
.
To connect to Nextcloud:
Start WinSCP
Press 'Session' in the menu
Press the 'New Session' menu option
Set the 'File protocol' dropdown to WebDAV
Set the 'Encryption' dropdown to TLS/SSL Implicit encryption
Fill in the hostname field:
example.com
Fill in the username field:
NEXTCLOUDUSERNAME
Fill in the password field:
NEXTCLOUDPASSWORD
Press the 'Advanced...' button
Navigate to 'Environment', 'Directories' on the left side
Fill in the 'Remote directory' field with the following:
/nextcloud/remote.php/dav/files/NEXTCLOUDUSERNAME/
Press the 'OK' button
Press the 'Save' button
Select the desired options and press the 'OK' button
Press the 'Login' button to connect to Nextcloud
Note
It is recommended to use an app password for the password if you use TOTP as WinSCP does not understand TOTP with Nextcloud at the time of writing (2022-11-07).