mirrors/nextcloud-documentation
3
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2025-10-26 11:18:02 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update access_webdav.rst

Browse Source
This commit is contained in:
Marius Blüm 2016-06-11 16:22:32 +02:00 committed by Lukas Reschke
parent 0d7f6d9b52
commit 28f941bfcb
No known key found for this signature in database
GPG Key ID: 9AB0ADB949B6898C
1 changed files with 78 additions and 78 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

156
user_manual/files/access_webdav.rst
View File

@ -1,53 +1,53 @@
=====================================
Accessing ownCloud Files Using WebDAV
=====================================
======================================
Accessing Nextcloud Files Using WebDAV
======================================
ownCloud fully supports the WebDAV protocol, and you can connect and synchronize
with your ownCloud files over WebDAV. In this chapter you will learn how to
connect Linux, Mac OS X, Windows, and mobile devices to your ownCloud server via
Nextcloud fully supports the WebDAV protocol, and you can connect and synchronize
with your Nextcloud files over WebDAV. In this chapter you will learn how to
connect Linux, Mac OS X, Windows, and mobile devices to your Nextcloud server via
WebDAV. Before we get into configuring WebDAV, let's take a quick look at the
recommended way of connecting client devices to your ownCloud servers.
recommended way of connecting client devices to your Nextcloud servers.
ownCloud Desktop and Mobile Clients
-----------------------------------
Nextcloud Desktop and Mobile Clients
------------------------------------
The recommended method for keeping your desktop PC synchronized with your
ownCloud server is by using the `ownCloud Desktop Client
<https://owncloud.org/install/#install-clients>`_. You can configure the ownCloud client
Nextcloud server is by using the `Nextcloud Desktop Client
<https://nextcloud.com/install/#install-clients>`_. You can configure the Nextcloud client
to save files in any local directory you want, and you choose which directories
on the ownCloud server to sync with. The client displays the current connection
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 method for syncing your ownCloud server with Android and
Apple iOS devices is by using the `ownCloud mobile apps
<https://owncloud.org/install/#install-clients>`_.
The recommended method for syncing your Nextcloud server with Android and
Apple iOS devices is by using the `Nextcloud mobile apps
<https://nextcloud.com/install/#install-clients>`_.
To connect to your ownCloud server with the **ownCloud** mobile apps, use the
To connect to your Nextcloud server with the **Nextcloud** mobile apps, use the
base URL and folder only::
example.com/owncloud
example.com/nextcloud
In addition to the mobile apps provided by ownCloud, you can use other apps to
connect to ownCloud from your mobile device using WebDAV. `WebDAV Navigator`_ is
In addition to the mobile apps provided by Nextcloud, you can use other apps to
connect to Nextcloud from your mobile device using WebDAV. `WebDAV Navigator`_ is
a good (proprietary) app for `Android devices`_, `iPhones`_, and `BlackBerry
devices`_. The URL to use on these is::
example.com/owncloud/remote.php/dav/files/USERNAME/
example.com/nextcloud/remote.php/dav/files/USERNAME/
WebDAV Configuration
--------------------
If you prefer, you may also connect your desktop PC to your ownCloud server by
If you prefer, you may also connect your desktop PC to your Nextcloud server by
using the WebDAV protocol rather than using a special client application. Web
Distributed Authoring and Versioning (WebDAV) is a Hypertext Transfer Protocol
(HTTP) extension that makes it easy to create, read, and edit files on Web
servers. With WebDAV you can access your ownCloud shares on Linux, Mac OS X and
servers. With WebDAV you can access your Nextcloud shares on Linux, Mac OS X and
Windows in the same way as any remote network share, and stay synchronized.
.. note:: In the following examples, You must adjust **example.com/** to the
URL of your ownCloud server installation.
URL of your Nextcloud server installation.
Accessing Files Using Linux
---------------------------
@ -58,9 +58,9 @@ Nautilus File Manager
^^^^^^^^^^^^^^^^^^^^^
Use the ``davs://`` protocol to connect the Nautilus file manager to your
ownCloud share::
Nextcloud share::
davs://example.com/owncloud/remote.php/dav/files/USERNAME/
davs://example.com/nextcloud/remote.php/dav/files/USERNAME/
.. note:: If your server connection is not HTTPS-secured, use `dav://` instead
of `davs://`.
@ -71,15 +71,15 @@ ownCloud share::
Accessing Files with KDE and Dolphin File Manager
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
To access your ownCloud files using the Dolphin file manager in KDE, use
To access your Nextcloud files using the Dolphin file manager in KDE, use
the ``webdav://`` protocol::
webdav://example.com/owncloud/remote.php/dav/files/USERNAME/
webdav://example.com/nextcloud/remote.php/dav/files/USERNAME/
.. image:: ../images/webdav_dolphin.png
:alt: screenshot of configuring Dolphin file manager to use WebDAV
You can create a permanent link to your ownCloud server:
You can create a permanent link to your Nextcloud server:
#. Open Dolphin and click "Network" in the left hand "Places" column.
#. Click on the icon labeled **Add a Network Folder**.
@ -88,13 +88,13 @@ You can create a permanent link to your ownCloud server:
#. Click **Next**.
#. Enter the following settings:
* Name: The name you want to see in the **Places** bookmark, for example ownCloud.
* Name: The name you want to see in the **Places** bookmark, for example Nextcloud.
* User: The ownCloud username you used to log in, for example admin.
* User: The Nextcloud username you used to log in, for example admin.
* Server: The ownCloud domain name, for example **example.com** (without
* Server: The Nextcloud domain name, for example **example.com** (without
**http://** before or directories afterwards).
* Folder -- Enter the path ``owncloud/remote.php/dav/files/USERNAME/``.
* Folder -- Enter the path ``nextcloud/remote.php/dav/files/USERNAME/``.
#. (Optional) Check the "Create icon checkbox" for a bookmark to appear in the
Places column.
#. (Optional) Provide any special settings or an SSL certificate in the "Port &
@ -104,7 +104,7 @@ Creating WebDAV Mounts on the Linux Command Line
------------------------------------------------
You can create WebDAV mounts from the Linux command line. This is useful if you
prefer to access ownCloud the same way as any other remote filesystem mount.
prefer to access Nextcloud the same way as any other remote filesystem mount.
The following example shows how to create a personal mount and have it mounted
automatically every time you log in to your Linux computer.
@ -122,10 +122,10 @@ automatically every time you log in to your Linux computer.
usermod -aG davfs2 <username>
3. Then create an ``owncloud`` directory in your home directory for the
3. Then create an ``nextcloud`` directory in your home directory for the
mountpoint, and ``.davfs2/`` for your personal configuration file::
mkdir ~/owncloud
mkdir ~/nextcloud
mkdir ~/.davfs2
4. Copy ``/etc/davfs2/secrets`` to ``~/.davfs2``::
@ -137,27 +137,27 @@ automatically every time you log in to your Linux computer.
chown <username>:<username> ~/.davfs2/secrets
chmod 600 ~/.davfs2/secrets
6. Add your ownCloud login credentials to the end of the ``secrets`` file,
using your ownCloud server URL and your ownCloud username and password::
6. Add your Nextcloud login credentials to the end of the ``secrets`` file,
using your Nextcloud server URL and your Nextcloud username and password::
example.com/owncloud/remote.php/dav/files/USERNAME/ <username> <password>
example.com/nextcloud/remote.php/dav/files/USERNAME/ <username> <password>
7. Add the mount information to ``/etc/fstab``::
example.com/owncloud/remote.php/dav/files/USERNAME/ /home/<username>/owncloud
example.com/nextcloud/remote.php/dav/files/USERNAME/ /home/<username>/nextcloud
davfs user,rw,auto 0 0
8. Then test that it mounts and authenticates by running the following
command. If you set it up correctly you won't need root permissions::
mount ~/owncloud
mount ~/nextcloud
9. You should also be able to unmount it::
umount ~/owncloud
umount ~/nextcloud
Now every time you login to your Linux system your ownCloud share should
automatically mount via WebDAV in your ``~/owncloud`` directory. If you prefer
Now every time you login to your Linux system your Nextcloud share should
automatically mount via WebDAV in your ``~/nextcloud`` directory. If you prefer
to mount it manually, change ``auto`` to ``noauto`` in ``/etc/fstab``.
Known Issues
@ -194,7 +194,7 @@ Accessing Files Using Mac OS X
.. note:: The Mac OS X Finder suffers from a `series of implementation problems
<http://sabre.io/dav/clients/finder/>`_ and should only be used if the
ownCloud server runs on **Apache** and **mod_php**, or **Nginx 1.3.8+**.
Nextcloud server runs on **Apache** and **mod_php**, or **Nginx 1.3.8+**.
To access files through the Mac OS X Finder:
@ -205,12 +205,12 @@ To access files through the Mac OS X Finder:
2. Specify the address of the server in the **Server Address** field.
.. image:: ../images/osx_webdav1.png
:alt: Screenshot of entering your ownCloud server address on Mac OS X
:alt: Screenshot of entering your Nextcloud server address on Mac OS X
For example, the URL used to connect to the ownCloud server
For example, the URL used to connect to the Nextcloud server
from the Mac OS X Finder is::
https://example.com/owncloud/remote.php/dav/files/USERNAME/
https://example.com/nextcloud/remote.php/dav/files/USERNAME/
.. image:: ../images/osx_webdav2.png
@ -228,13 +228,13 @@ Accessing Files Using Microsoft Windows
It is best to use a suitable WebDAV client from the
`WebDAV Project page <http://www.webdav.org/projects/>`_ .
If you must use the native Windows implementation, you can map ownCloud to a new
drive. Mapping to a drive enables you to browse files stored on an ownCloud
If you must use the native Windows implementation, you can map Nextcloud to a new
drive. Mapping to a drive enables you to browse files stored on an Nextcloud
server the way you would files stored in a mapped network drive.
Using this feature requires network connectivity. If you want to store your
files offline, use the ownCloud Desktop Client to sync all files on your
ownCloud to one or more directories of your local hard drive.
files offline, use the Nextcloud Desktop Client to sync all files on your
Nextcloud to one or more directories of your local hard drive.
.. note:: Prior to mapping your drive, you must permit the use of Basic
Authentication in the Windows Registry. The procedure is documented in
@ -257,21 +257,21 @@ the drive:
net use Z: https://<drive_path>/remote.php/dav/files/USERNAME/ /user:youruser
yourpassword
where <drive_path> is the URL to your ownCloud server.
where <drive_path> is the URL to your Nextcloud server.
For example: ``net use Z: https://example.com/owncloud/remote.php/dav/files/USERNAME/
For example: ``net use Z: https://example.com/nextcloud/remote.php/dav/files/USERNAME/
/user:youruser yourpassword``
The computer maps the files of your ownCloud account to the drive letter Z.
The computer maps the files of your Nextcloud account to the drive letter Z.
.. note:: Though not recommended, you can also mount the ownCloud server
.. 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::
net use Z: \\example.com@ssl\owncloud\remote.php\dav /user:youruser
net use Z: \\example.com@ssl\nextcloud\remote.php\dav /user:youruser
yourpassword
Mapping Drives With Windows Explorer
@ -282,17 +282,17 @@ To map a drive using the Microsoft Windows Explorer:
1. Migrate to your computer in Windows Explorer.
2. Right-click on **Computer** entry and select **Map network drive...** from
the drop-down menu.
3. Choose a local network drive to which you want to map ownCloud.
4. Specify the address to your ownCloud instance, followed by
3. Choose a local network drive to which you want to map Nextcloud.
4. Specify the address to your Nextcloud instance, followed by
**/remote.php/dav/files/USERNAME/**.
For example::
https://example.com/owncloud/remote.php/dav/files/USERNAME/
https://example.com/nextcloud/remote.php/dav/files/USERNAME/
.. note:: For SSL protected servers, check **Reconnect at logon** to ensure
that the mapping is persistent upon subsequent reboots. If you want to
connect to the ownCloud server as a different user, check **Connect using
connect to the Nextcloud server as a different user, check **Connect using
different credentials**.
.. figure:: ../images/explorer_webdav.png
@ -301,7 +301,7 @@ To map a drive using the Microsoft Windows Explorer:
5. Click the ``Finish`` button.
Windows Explorer maps the network drive, making your ownCloud instance
Windows Explorer maps the network drive, making your Nextcloud instance
available.
Accessing Files Using Cyberduck
@ -320,7 +320,7 @@ To use Cyberduck:
``example.com``
2. Specify the appropriate port. The port you choose depends on whether or not
your ownCloud server supports SSL. Cyberduck requires that you select a
your Nextcloud server supports SSL. Cyberduck requires that you select a
different connection type if you plan to use SSL. For example:
80 (for WebDAV)
@ -332,16 +332,16 @@ the 'Path' field. For example:
``remote.php/dav/files/USERNAME/``
Now Cyberduck enables file access to the ownCloud server.
Now Cyberduck enables file access to the Nextcloud server.
Accessing public shares over WebDAV
-----------------------------------
ownCloud provides the possibility to access public shares over WebDAV.
Nextcloud provides the possibility to access public shares over WebDAV.
To access the public share, open::
https://example.com/owncloud/public.php/dav
https://example.com/nextcloud/public.php/dav
in a WebDAV client, use the share token as username and the (optional) share password
as password.
@ -358,7 +358,7 @@ Solution 1
The Windows WebDAV Client might not support Server Name Indication (SNI) on
encrypted connections. If you encounter an error mounting an SSL-encrypted
ownCloud instance, contact your provider about assigning a dedicated IP address
Nextcloud instance, contact your provider about assigning a dedicated IP address
for your SSL-based server.
Solution 2
@ -401,12 +401,12 @@ Known problems and their solutions are documented in the KB2123563_ article.
Problem
^^^^^^^
Cannot map ownCloud as a WebDAV drive in Windows using self-signed certificate.
Cannot map Nextcloud as a WebDAV drive in Windows using self-signed certificate.
Solution
^^^^^^^^
#. Go to the your ownCloud instance via your favorite Web browser.
#. Go to the your Nextcloud instance via your favorite Web browser.
#. Click through until you get to the certificate error in the browser status
line.
#. View the cert, then from the Details tab, select Copy to File.
@ -449,29 +449,29 @@ To create a folder with the current date as name:
.. code-block:: bash
$ curl -u user:pass -X MKCOL "https://example.com/owncloud/remote.php/dav/files/USERNAME/$(date '+%d-%b-%Y')"
$ curl -u user:pass -X MKCOL "https://example.com/nextcloud/remote.php/dav/files/USERNAME/$(date '+%d-%b-%Y')"
To upload a file ``error.log`` into that directory:
.. code-block:: bash
$ curl -u user:pass -T error.log "https://example.com/owncloud/remote.php/dav/files/USERNAME/$(date '+%d-%b-%Y')/error.log"
$ curl -u user:pass -T error.log "https://example.com/nextcloud/remote.php/dav/files/USERNAME/$(date '+%d-%b-%Y')/error.log"
To move a file:
.. code-block:: bash
$ curl -u user:pass -X MOVE --header 'Destination: https://example.com/owncloud/remote.php/dav/files/USERNAME/target.jpg' https://example.com/owncloud/remote.php/dav/files/USERNAME/source.jpg
$ 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
To get the properties of files in the root folder:
.. code-block:: bash
$ curl -X PROPFIND -H "Depth: 1" -u user:pass https://example.com/owncloud/remote.php/dav/files/USERNAME/ | xml_pp
$ 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://owncloud.org/ns" xmlns:s="http://sabredav.org/ns">
<d:multistatus xmlns:d="DAV:" xmlns:oc="http://nextcloud.com/ns" xmlns:s="http://sabredav.org/ns">
<d:response>
<d:href>/owncloud/remote.php/dav/files/USERNAME/</d:href>
<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>
@ -486,7 +486,7 @@ To get the properties of files in the root folder:
</d:propstat>
</d:response>
<d:response>
<d:href>/owncloud/remote.php/dav/files/USERNAME/welcome.txt</d:href>
<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>
@ -504,9 +504,9 @@ To get the properties of files in the root folder:
.. _KB2668751: https://support.microsoft.com/kb/2668751
.. _KB2123563: https://support.microsoft.com/kb/2123563
.. _in your file manager: http://en.wikipedia.org/wiki/Webdav#WebDAV_client_applications
.. _ownCloud sync clients: https://doc.owncloud.org/desktop/2.1/
.. _Mount ownCloud to a local folder without sync: https://owncloud.org/use/webdav/
.. _Android: https://github.com/owncloud/android
.. _ownCloud sync clients: https://doc.nextcloud.com/desktop/2.1/
.. _Mount ownCloud to a local folder without sync: https://nextcloud.com/use/webdav/
.. _Android: https://github.com/nextcloud/android
.. _WebDAV Navigator: http://seanashton.net/webdav/
.. _Android devices: https://play.google.com/store/apps/details?id=com.schimera.webdavnavlite
.. _iPhones: https://itunes.apple.com/app/webdav-navigator/id382551345