Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

fix: Improve documentation about frequent disconnections of the WebDAV windows client #12326

Merged
merged 1 commit into from
Oct 29, 2024
Merged

fix: Improve documentation about frequent disconnections of the WebDAV windows client #12326

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 23 additions & 23 deletions user_manual/files/access_webdav.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ Nextcloud fully supports the WebDAV protocol, and you can connect and synchroniz
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,
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
Expand All @@ -18,14 +18,14 @@ 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 <https://nextcloud.com/install/#install-clients>`_.
using the `official Nextcloud sync clients <https://nextcloud.com/install/#install-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 recommended way to synchronize Android and Apple iOS devices is by using
the `official Nextcloud mobile apps <https://nextcloud.com/install/>`_.

To connect the official Nextcloud apps to a Nextcloud server use the
Expand All @@ -39,10 +39,10 @@ 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
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
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
Expand All @@ -56,16 +56,16 @@ 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
<https://github.com/nextcloud/server/issues/32729#issuecomment-1556667151>`_. 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
.. 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
<https://github.com/nextcloud/server/issues/32729#issuecomment-1556667151>`_. 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
Expand Down Expand Up @@ -265,7 +265,7 @@ files offline, use the Desktop Client to sync all files on your
Nextcloud to one or more directories of your local hard drive.

.. 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 to ``HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters``.
Expand All @@ -292,13 +292,13 @@ the drive:

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

.. note:: If you get the following error
.. error:: 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.
or frequent disconnections, 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.

An alternative command syntax is::
Expand Down Expand Up @@ -359,7 +359,7 @@ To use Cyberduck:

3. 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/``

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

Unfortunately is this a limitation of WebDAV itself, because it does not provide a way for the client
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.

Expand Down