Skip to content

Commit d66c05a

Browse files
committed
fix: Improve documentation about frequent disconnections of the WebDAV windows client
Signed-off-by: Louis Chemineau <[email protected]>
1 parent 31e353c commit d66c05a

File tree

1 file changed

+23
-23
lines changed

1 file changed

+23
-23
lines changed

user_manual/files/access_webdav.rst

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,9 @@ Nextcloud fully supports the WebDAV protocol, and you can connect and synchroniz
66
with Nextcloud Files over WebDAV. In this chapter, you will learn how to
77
connect Linux, macOS, Windows, and mobile devices to your Nextcloud server.
88

9-
WebDAV stands for Distributed Authoring and Versioning. It is an HTTP extension
10-
that makes it easy to create, read, and edit files hosted on remote Web servers. With
11-
a WebDAV client, you can access your Nextcloud Files (including shares) on Linux,
9+
WebDAV stands for Distributed Authoring and Versioning. It is an HTTP extension
10+
that makes it easy to create, read, and edit files hosted on remote Web servers. With
11+
a WebDAV client, you can access your Nextcloud Files (including shares) on Linux,
1212
macOS and Windows in a similar way as any remote network share, and stay synchronized.
1313

1414
Before we get into configuring WebDAV, let's take a quick look at the
@@ -18,14 +18,14 @@ Official Nextcloud desktop and mobile clients
1818
---------------------------------------------
1919

2020
The recommended way to synchronize a computer with a Nextcloud server is by
21-
using the `official Nextcloud sync clients <https://nextcloud.com/install/#install-clients>`_.
21+
using the `official Nextcloud sync clients <https://nextcloud.com/install/#install-clients>`_.
2222
You can configure the client to save files in any local directory and you can choose which
2323
directories on the Nextcloud server to sync with. The client displays the
2424
current connection status and logs all activity, so you always know which
2525
remote files have been downloaded to your PC and you can verify that files
2626
created and updated on your local PC are properly synchronized with the server.
2727

28-
The recommended way to synchronize Android and Apple iOS devices is by using
28+
The recommended way to synchronize Android and Apple iOS devices is by using
2929
the `official Nextcloud mobile apps <https://nextcloud.com/install/>`_.
3030

3131
To connect the official Nextcloud apps to a Nextcloud server use the
@@ -39,10 +39,10 @@ Third-party WebDAV clients
3939
--------------------------
4040

4141
If you prefer, you may also connect your computer to your Nextcloud server by
42-
using any third-party client that supports the WebDAV protocol (including what may be
42+
using any third-party client that supports the WebDAV protocol (including what may be
4343
built into your operating system).
4444

45-
You can also use third-party WebDAV capable apps to connect your mobile
45+
You can also use third-party WebDAV capable apps to connect your mobile
4646
device to Nextcloud.
4747

4848
When using third-party clients, keep in mind that they may not be optimized for use with
@@ -56,16 +56,16 @@ Mobile clients that Nextcloud community members have reported using include:
5656
The URL to use when configuring third-party apps to connect to Nextcloud is a bit lengthier than the one for official clients::
5757

5858
https://cloud.example.com/remote.php/dav/files/USERNAME/
59-
59+
6060
https://example.com/nextcloud/remote.php/dav/files/USERNAME/ (if Nextcloud is installed in a subdirectory called "nextcloud")
6161

62-
.. note:: When using a third-party WebDAV client (including your operating system's
63-
built-in client), you should use an application password for login rather than your
64-
regular password. In addition improved security, this `increases performance significantly
65-
<https://github.com/nextcloud/server/issues/32729#issuecomment-1556667151>`_. To
66-
configure an application password, log into the Nextcloud Web interface, click on the avatar
67-
in the top right and choose *Personal settings*. Then choose *Security* in the left
68-
sidebar and scroll to the very bottom. There you can create an app password (which can
62+
.. note:: When using a third-party WebDAV client (including your operating system's
63+
built-in client), you should use an application password for login rather than your
64+
regular password. In addition improved security, this `increases performance significantly
65+
<https://github.com/nextcloud/server/issues/32729#issuecomment-1556667151>`_. To
66+
configure an application password, log into the Nextcloud Web interface, click on the avatar
67+
in the top right and choose *Personal settings*. Then choose *Security* in the left
68+
sidebar and scroll to the very bottom. There you can create an app password (which can
6969
also be revoked in the future without changing your main user password).
7070

7171
.. note:: In the following examples, you should replace **example.com/nextcloud** with the
@@ -265,7 +265,7 @@ files offline, use the Desktop Client to sync all files on your
265265
Nextcloud to one or more directories of your local hard drive.
266266

267267
.. note:: Windows 10 now defaults to allow Basic Authentication if HTTPS is enabled before mapping your drive.
268-
268+
269269
On older versions of Windows, you must permit the use of Basic Authentication in the Windows Registry:
270270

271271
* launch ``regedit`` and navigate to ``HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters``.
@@ -292,13 +292,13 @@ the drive:
292292

293293
The computer maps the files of your Nextcloud account to the drive letter Z.
294294

295-
.. note:: If you get the following error
295+
.. error:: If you get the following error
296296
``System error 67 has occurred. The network name cannot be found.``,
297-
open the **Services** app and make sure that the ``WebClient``
298-
service is running and started automatically at startup.
299-
297+
or frequent disconnections, open the **Services** app and make sure
298+
that the ``WebClient`` service is running and started automatically at startup.
299+
300300
.. note:: Though not recommended, you can also mount the Nextcloud server using HTTP, leaving the connection unencrypted.
301-
301+
302302
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.
303303

304304
An alternative command syntax is::
@@ -359,7 +359,7 @@ To use Cyberduck:
359359

360360
3. Use the 'More Options' drop-down menu to add the rest of your WebDAV URL into
361361
the 'Path' field.
362-
362+
363363
For example: ``remote.php/dav/files/USERNAME/``
364364

365365
Now Cyberduck enables file access to the Nextcloud server.
@@ -431,7 +431,7 @@ of in Nextcloud available space and instead shows the size of the C: drive with
431431
Answer
432432
^^^^^^
433433

434-
Unfortunately is this a limitation of WebDAV itself, because it does not provide a way for the client
434+
Unfortunately is this a limitation of WebDAV itself, because it does not provide a way for the client
435435
to get the available free space from the server. Windows automatically falls back to show the size of
436436
the C: drive with its available space instead. So unfortunately there is no real solution to this problem.
437437

0 commit comments

Comments
 (0)