diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index 536462c51..354d00282 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -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 -`_. You can configure the ownCloud client +Nextcloud server is by using the `Nextcloud Desktop Client +`_. 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 -`_. +The recommended method for syncing your Nextcloud server with Android and +Apple iOS devices is by using the `Nextcloud mobile apps +`_. -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 -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 : ~/.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/ + example.com/nextcloud/remote.php/dav/files/USERNAME/ 7. Add the mount information to ``/etc/fstab``:: - example.com/owncloud/remote.php/dav/files/USERNAME/ /home//owncloud + example.com/nextcloud/remote.php/dav/files/USERNAME/ /home//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 `_ 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 `_ . -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:///remote.php/dav/files/USERNAME/ /user:youruser yourpassword - where is the URL to your ownCloud server. + where 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 - + - /owncloud/remote.php/dav/files/USERNAME/ + /nextcloud/remote.php/dav/files/USERNAME/ Tue, 13 Oct 2015 17:07:45 GMT @@ -486,7 +486,7 @@ To get the properties of files in the root folder: - /owncloud/remote.php/dav/files/USERNAME/welcome.txt + /nextcloud/remote.php/dav/files/USERNAME/welcome.txt Tue, 13 Oct 2015 17:07:35 GMT @@ -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