diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index 508bc5f34..68bf9308e 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -3,18 +3,19 @@ Accessing Nextcloud files using WebDAV ====================================== 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 +with Nextcloud Files over WebDAV. In this chapter, you will learn how to connect Linux, macOS, 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 Nextcloud servers. .. 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. + 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. -.. note:: In the following examples, you must use an app-password for login, which you can generate in your security settings. +.. note:: In the following examples, you must use an application password for login, which you can generate in your security settings. + Nextcloud Desktop and mobile clients ------------------------------------ @@ -42,6 +43,7 @@ a good (proprietary) app for `Android devices`_ and `iPhones`_. The URL to use o example.com/nextcloud/remote.php/dav/files/USERNAME/ + WebDAV configuration -------------------- @@ -49,9 +51,10 @@ 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 Nextcloud shares on Linux, macOS and +servers. With WebDAV, you can access your Nextcloud shares on Linux, macOS and Windows in the same way as any remote network share, and stay synchronized. + Accessing files using Linux --------------------------- @@ -74,12 +77,11 @@ share:: of ``davs://``: .. image:: ../images/webdav_gnome3_nautilus.png - :alt: screenshot of configuring Nautilus file manager to use WebDAV + :alt: Screenshot of configuring Nautilus file manager to use WebDAV -.. note:: The same method works for other file managers that use GVfs, +.. note:: The same method works for other file managers that use GVFS, such as MATE's Caja and Cinnamon's Nepomuk. - Accessing files with KDE and Dolphin file manager ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -89,22 +91,22 @@ the ``webdav://`` protocol:: webdav://example.com/nextcloud/remote.php/dav/files/USERNAME/ .. image:: ../images/webdav_dolphin.png - :alt: screenshot of configuring Dolphin file manager to use WebDAV + :alt: Screenshot of configuring Dolphin file manager to use WebDAV You can create a permanent link to your Nextcloud server: -#. Open Dolphin and click "Network" in the left hand "Places" column. +#. Open Dolphin and click "Network" in the left-hand "Places" column. #. Click on the icon labeled **Add a Network Folder**. The resulting dialog should appear with WebDAV already selected. #. If WebDAV is not selected, select it. #. Click **Next**. #. Enter the following settings: - * Name: The name you want to see in the **Places** bookmark, for example Nextcloud. + * 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. + * User: the Nextcloud username you used to log in, for example, admin. - * Server: The Nextcloud 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 ``nextcloud/remote.php/dav/files/USERNAME/``. #. (Optional) Check the "Create icon" checkbox for a bookmark to appear in the @@ -112,6 +114,7 @@ You can create a permanent link to your Nextcloud server: #. (Optional) Provide any special settings or an SSL certificate in the "Port & Encrypted" checkbox. + Creating WebDAV mounts on the Linux command line ------------------------------------------------ @@ -120,36 +123,36 @@ 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. -1. Install the ``davfs2`` WebDAV filesystem driver, which allows you to mount +#. Install the ``davfs2`` WebDAV filesystem driver, which allows you to mount WebDAV shares just like any other remote filesystem. Use this command to install it on Debian/Ubuntu:: apt-get install davfs2 -2. Use this command to install it on CentOS, Fedora, and openSUSE:: +#. Use this command to install it on CentOS, Fedora, and openSUSE:: yum install davfs2 -3. Add yourself to the ``davfs2`` group:: +#. Add yourself to the ``davfs2`` group:: usermod -aG davfs2 -3. Then create a ``nextcloud`` directory in your home directory for the - mountpoint, and ``.davfs2/`` for your personal configuration file:: +#. Then create a ``nextcloud`` directory in your home directory for the + mount point, and ``.davfs2/`` for your personal configuration file:: mkdir ~/nextcloud mkdir ~/.davfs2 -4. Copy ``/etc/davfs2/secrets`` to ``~/.davfs2``:: +#. Copy ``/etc/davfs2/secrets`` to ``~/.davfs2``:: cp /etc/davfs2/secrets ~/.davfs2/secrets -5. Set yourself as the owner and make the permissions read-write owner only:: +#. Set yourself as the owner and make the permissions read-write owner only:: chown : ~/.davfs2/secrets chmod 600 ~/.davfs2/secrets -6. Add your Nextcloud login credentials to the end of the ``secrets`` file, +#. Add your Nextcloud login credentials to the end of the ``secrets`` file, using your Nextcloud server URL and your Nextcloud username and password:: https://example.com/nextcloud/remote.php/dav/files/USERNAME/ @@ -158,17 +161,16 @@ automatically every time you log in to your Linux computer. for example /home/user/nextcloud john 1234 -7. Add the mount information to ``/etc/fstab``:: +#. Add the mount information to ``/etc/fstab``:: https://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 +#. 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 ~/nextcloud -9. You should also be able to unmount it:: +#. You should also be able to unmount it:: umount ~/nextcloud @@ -176,6 +178,7 @@ 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 ------------ @@ -203,7 +206,8 @@ Copy ``mycertificate.pem`` to ``/etc/davfs2/certs/``. Then edit ``/etc/davfs2/davfs2.conf`` and uncomment the line ``servercert``. Now add the path of your certificate as in this example:: - servercert /etc/davfs2/certs/mycertificate.pem + servercert /etc/davfs2/certs/mycertificate.pem + Accessing files using macOS --------------------------- @@ -214,19 +218,19 @@ Accessing files using macOS To access files through the macOS Finder: -1. From the Finder’s top menu bar, choose **Go > Connect to Server…**: +#. From the Finder's top menu bar, choose **Go > Connect to Server…**: - .. image:: ../images/osx_webdav1.png + .. image:: ../images/osx_webdav1.png :alt: Screenshot of entering your Nextcloud server address on macOS -2. When the **Connect to Server…** window opens, enter your Nextcloud server’s WebDAV address in the **Server Address:** field, i.e.:: +#. 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/ - .. image:: ../images/osx_webdav2.png - :alt: Screenshot: Enter Nextcloud server address in “Connect to Server…” dialog box + .. image:: ../images/osx_webdav2.png + :alt: Screenshot: Enter Nextcloud server address in "Connect to Server…" dialog box -3. Click **Connect**. Your WebDAV server should appear on the Desktop as a shared disk drive. +#. Click **Connect**. Your WebDAV server should appear on the Desktop as a shared disk drive. Accessing files using Microsoft Windows @@ -234,22 +238,20 @@ Accessing files using 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 files stored in a mapped network drive. +Nextcloud server the way you would browse files stored in a mapped network drive. Using this feature requires network connectivity. If you want to store your 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 prior to 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``. - Create or edit the ``DWORD`` value ``BasicAuthLevel`` (Windows Vista, 7 and 8) or - ``UseBasicAuth`` (Windows XP and Windows Server 2003) and set its value data - to ``1`` for SSL connections. Value ``0`` means that Basic Authentication is disabled, - a value of ``2`` allows both SSL and non-SSL connections (not recommended). - Then exit Registry Editor, and restart the computer. +.. 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``. + * Create or edit the ``BasicAuthLevel`` (Windows Vista, 7 and 8), or ``UseBasicAuth`` (Windows XP and Windows Server 2003), ``DWORD`` value and set its value data to ``1`` for SSL connections. + A value of ``0`` means that Basic Authentication is disabled, and a value of ``2`` allows both SSL and non-SSL connections (not recommended). + * Then exit Registry Editor, and restart the computer. Mapping drives with the command line ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -257,90 +259,87 @@ Mapping drives with the command line The following example shows how to map a drive using the command line. To map the drive: -1. Open a command prompt in Windows. -2. Enter the following line in the command prompt to map to the computer Z +#. Open a command prompt in Windows. +#. Enter the following line in the command prompt to map to the computer Z drive:: - net use Z: https:///remote.php/dav/files/USERNAME/ /user:youruser + net use Z: https:///remote.php/dav/files/USERNAME/ /user:youruser yourpassword + + with as the URL to your Nextcloud server. + For example:: + + net use Z: https://example.com/nextcloud/remote.php/dav/files/USERNAME/ /user:youruser yourpassword + + The computer maps the files of your Nextcloud account to the drive letter Z. + + .. 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\nextcloud\remote.php\dav /user:youruser yourpassword - where is the URL to your Nextcloud server. - -For example: ``net use Z: https://example.com/nextcloud/remote.php/dav/files/USERNAME/ -/user:youruser yourpassword`` - - The computer maps the files of your Nextcloud account to the drive letter Z. - -.. 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\nextcloud\remote.php\dav /user:youruser - yourpassword - Mapping drives with Windows Explorer ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -To map a drive using the Microsoft Windows Explorer: +To map a drive using Microsoft Windows Explorer: -1. Open Windows Explorer on your MS Windows computer. -2. Right-click on **Computer** entry and select **Map network drive…** from +#. Open Windows Explorer on your MS Windows computer. +#. 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 Nextcloud. -4. Specify the address to your Nextcloud instance, followed by +#. Choose a local network drive to which you want to map Nextcloud. +#. Specify the address to your Nextcloud instance, followed by **/remote.php/dav/files/USERNAME/**. - For example:: + For example:: https://example.com/nextcloud/remote.php/dav/files/USERNAME/ -.. note:: For SSL protected servers, check **Reconnect at sign-in** to ensure + .. 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**. -.. figure:: ../images/explorer_webdav.png - :scale: 80% - :alt: screenshot of mapping WebDAV on Windows Explorer + .. figure:: ../images/explorer_webdav.png + :scale: 80% + :alt: Screenshot of mapping WebDAV on Windows Explorer 5. Click the ``Finish`` button. - Windows Explorer maps the network drive, making your Nextcloud instance - available. +Windows Explorer maps the network drive, making your Nextcloud instance available. + Accessing files using Cyberduck ------------------------------- -`Cyberduck `_ is an open source FTP and SFTP, -WebDAV, OpenStack Swift, and Amazon S3 browser designed for file transfers on -macOS and Windows. +`Cyberduck `_ is an open source FTP, SFTP, WebDAV, OpenStack Swift, and Amazon S3 browser designed for file transfers on macOS and Windows. .. note:: This example uses Cyberduck version 4.2.1. To use Cyberduck: -1. Specify a server without any leading protocol information. For example: +1. Specify a server without any leading protocol information. - ``example.com`` + For example: ``example.com`` -2. 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: +2. Specify the appropriate port. - 80 (for WebDAV) + 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. - 443 (for WebDAV (HTTPS/SSL)) + For example: + * ``80`` for unencrypted WebDAV + * ``443`` for secure WebDAV (HTTPS/SSL) 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/`` + the 'Path' field. + + For example: ``remote.php/dav/files/USERNAME/`` Now Cyberduck enables file access to the Nextcloud server. + Accessing public shares over WebDAV ----------------------------------- @@ -350,13 +349,10 @@ To access the public share, open:: https://example.com/nextcloud/public.php/webdav -in a WebDAV client, use the share token as username and the (optional) share password -as password. For example, with a share link https://example.com/s/kFy9Lek5sm928xP, ``kFy9Lek5sm928xP`` will be the username. +in a WebDAV client, use the share token as username and the (optional) share password as the password. For example, with a share link https://example.com/s/kFy9Lek5sm928xP, ``kFy9Lek5sm928xP`` will be the username. -.. note:: **Settings** → **Administration** → **Sharing** → **Allow users on this - server to send shares to other servers**. This option also allows WebDAV access - to public shares needs to be enabled in order to make this feature work, - except if cURL is being used (see below). +.. note:: **Settings** → **Administration** → **Sharing** → **Allow users on this server to send shares to other servers**. + This option also allows WebDAV access to public shares and needs to be enabled to make this feature work, except if cURL is being used (see below). Known problems -------------- @@ -413,43 +409,46 @@ Known problems and their solutions are documented in the KB2123563_ article. Problem ^^^^^^^ -Cannot map Nextcloud as a WebDAV drive in Windows using self-signed certificate. +Cannot map Nextcloud as a WebDAV drive in Windows using a self-signed certificate. Solution ^^^^^^^^ - #. 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. - #. Save to the desktop with an arbitrary name, for example ``myNextcloud.pem``. - #. Start, Run, MMC. - #. File, Add/Remove Snap-In. - #. Select Certificates, Click Add, My User Account, then Finish, then OK. - #. Dig down to Trust Root Certification Authorities, Certificates. - #. Right-Click Certificate, Select All Tasks, Import. - #. Select the Save Cert from the Desktop. - #. Select Place all Certificates in the following Store, Click Browse. - #. Check the Box that says Show Physical Stores, Expand out Trusted Root - Certification Authorities, and select Local Computer there, click OK, - Complete the Import. - #. Check the list to make sure it shows up. You will probably need to Refresh - before you see it. Exit MMC. - #. Open Browser, select Tools, Delete Browsing History. - #. Select all but In Private Filtering Data, complete. - #. Go to Internet Options, Content Tab, Clear SSL State. - #. Close browser, then re-open and test. +#. Access to your Nextcloud instance via your favorite Web browser. +#. Click through until you get to the certificate error in the browser status + line. +#. 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. +#. Dig down to 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. -Problem -^^^^^^^ +For Firefox users: -You cannot download more than 50 MB or upload large files when the upload takes -longer than 30 minutes using Web Client in Windows 7. +#. 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. -Solution -^^^^^^^^ +For Chrome-based browsers (Chrome, Chromium, Microsoft Edge) users: -Workarounds are documented in the KB2668751_ article. +#. 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. Accessing files using cURL @@ -457,10 +456,8 @@ Accessing files using 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. +.. 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. To create a folder with the current date as name: @@ -518,16 +515,14 @@ To get the properties of files in the root folder: - - Accessing files using WinSCP ------------------------------- -`WinSCP `_ is an open source free SFTP client, FTP client, WebDAV client, S3 client 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 manager functionality. +`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 via: wine WinSCP.exe. +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: @@ -536,19 +531,18 @@ To connect to Nextcloud: * Press the 'New Session' menu option * Set the 'File protocol' dropdown to WebDAV * Set the 'Encryption' dropdown to TSL/SSL Implicit encryption -* Fill in the hostname field: example.com -* Fill in the username field: NEXTCLOUDUSERNAME -* Fill in the password field: NEXTCLOUDPASSWORD +* 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/ +* 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 in Nextcloud at the time of writing (2022-11-07). - +.. 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). .. _KB2668751: https://web.archive.org/web/20211008025539/https://support.microsoft.com/en-us/topic/you-cannot-download-more-than-50-mb-or-upload-large-files-when-the-upload-takes-longer-than-30-minutes-using-web-client-in-windows-7-8709ae9d-e808-c5a0-95d0-9a7143c50b11 diff --git a/user_manual/groupware/sync_gnome.rst b/user_manual/groupware/sync_gnome.rst index fdb2a4463..38c92eb83 100644 --- a/user_manual/groupware/sync_gnome.rst +++ b/user_manual/groupware/sync_gnome.rst @@ -2,41 +2,34 @@ Synchronizing with the GNOME desktop ==================================== -The `GNOME desktop `_ has built-in support for Nextcloud's calendar, -contacts and tasks which will be displayed by the Evolution PIM or the -Calendar, Tasks and Contacts app as well has for files, which it -integrates into the Nautilus file manager via WebDAV. The latter works -only while the computer is connected. +The `GNOME desktop `_ has built-in support for Nextcloud's calendar, contacts, and tasks which will be displayed by the Evolution Personal Information Manager (PIM), or the Calendar, Tasks, and Contacts apps. +Similarly, Files integrates into the Nautilus file manager via WebDAV. The latter works only while the computer is connected. This can be done by following these steps: -1. In the GNOME settings, open Online Accounts. -2. Under "Add an account" pick ``Nextcloud``: +#. In the GNOME settings, open Online Accounts. +#. Under "Add an account" pick ``Nextcloud``: -.. image:: ../images/gnome-online-accounts.png + .. image:: ../images/gnome-online-accounts.png -3. Enter your server URL, username and password. If you have enabled two - factor authentification, you need to generate an app-password/token, because GNOME Online Accounts - `doesn't support Nextcloud's webflow login yet `_ +#. Enter your server URL, username, and password. + If you have enabled two-factor authentification (2FA), you need to generate an application password/token, because GNOME Online Accounts + `doesn't support Nextcloud's WebFlow login yet `_ (`Learn more `_): -.. TODO ON RELEASE: Update version number above on release + .. TODO ON RELEASE: Update version number above on release -.. image:: ../images/goa-add-nextcloud-account.png + .. image:: ../images/goa-add-nextcloud-account.png -4. In the next window, select which resources GNOME should access and +#. In the next window, select which resources GNOME should access and press the cross in the top right to close: -.. image:: ../images/goa-nextcloud-select.png + .. image:: ../images/goa-nextcloud-select.png -Nextcloud tasks, calendars and contacts should now be visible in the -Evolution PIM, the task, contacts and calendars app. +Nextcloud tasks, calendars, and contacts should now be visible in the Evolution PIM, as well as the Task, Contacts, and Calendars apps. -Files will be shown as a WebDAV resource in the Nautilus file manager -(and also be available in the GNOME file open/save -dialogues). Documents should be integrated into the GNOME Documents -app. +Files will be shown as a WebDAV resource in the Nautilus file manager, and also be available in the GNOME file open/save dialogues. +Documents should be integrated into the GNOME Documents app. -All resources should also be searchable from anywhere by pressing the Windows key and entering a -search term. +All resources should also be searchable from anywhere by pressing the Windows key and entering a search term. diff --git a/user_manual/groupware/sync_thunderbird.rst b/user_manual/groupware/sync_thunderbird.rst index 9c827bb47..ba947abd9 100644 --- a/user_manual/groupware/sync_thunderbird.rst +++ b/user_manual/groupware/sync_thunderbird.rst @@ -2,92 +2,97 @@ Synchronizing with Thunderbird ============================== -`Thunderbird `_ is a feature-rich and mature mail client that can be turned into a full-fledged PIM. Since version 102, it supports address book synchronisation via CardDAV and automatic discovering calendars and address books available on the server. +`Thunderbird `_ is a feature-rich and mature mail client that can be turned into a full-fledged Personal Information Manager (PIM). Since version 102, it supports address book synchronization via CardDAV and automatic discovery of calendars and address books available on the server. Recommended method ------------------ -Since Thunderbird 102, there is a native support for CardDAV protocol. +Since Thunderbird 102, the CardDAV protocol is natively supported. To enable it: * On the address book view, click the down arrow near "**New Address Book**" and choose "**Add CardDAV Address Book**". * In the next window, type your **user name** and **URL of your server**. -* The next window will ask your username and password for this account. +* The next window will ask for your username and password for this account. * The previous window will be refreshed and ask you which address books you wish to sync. * Choose and then click **Continue**. -If you later add a new Address Book you can redo all of those steps and only the books not already synchronized will be suggested. +If you later want to add a new address book, you can redo all of those steps and only the books not already synchronized will be suggested. -For calendars there is too a native support of CalDAV. +For calendars, the CalDAV protocol is also natively supported. To enable it: * Click on "**+**" near Agendas on the agendas page. * Choose "**On the network**" on the next window. -* Type you "**user name**" and "**Url of the server**" and click on "Find Calendars". +* Type your "**user name**" and "**Url of the server**", then click on "Find Calendars". * Choose which agendas you want to add and click "**Subscribe**" -Same thing here, if you lately want to add more calendar just redo the procedure. +Same thing here, if you later want to add more calendars, just redo the procedure. -Alternative: using the TbSync addon +Alternative: Using the TbSync addon ----------------------------------- For this method, you need to have two add-ons installed: -1. `TbSync `_. -2. The `TbSync provider for CalDAV and CardDAV `_. +#. `TbSync `_. +#. `TbSync provider for CalDAV and CardDAV `_. -When they are installed, if you are on Windows, go to **Extras**/**Synchronisation settings (TbSync)** or **Edit/Synchronisation settings (TbSync)** if on Linux, and then: +When they are installed, go to **Extras**/**Synchronisation settings (TbSync)** if you are on Windows, or **Edit/Synchronisation settings (TbSync)** if on Linux, then: * In the account manager choose "**Add account** / **CalDAV / CardDAV account**" * In the next window, go with the default called **Automatic configuration** and click **next** -* Enter an **account name**, which you can freely choose, **user name**, **password** and the **URL of your server** and click **next** -* In the next window, TbSync should have autodiscovered the CalDAV and CardDAV addresses. When it has, click **Finish** -* Now check the box **Enable and synchronize this account**. TbSync will discover all address books and calenders your account has access to on the server -* Check the box next to each calender and address book you want to have synchronised, also set how often you want them to be synchronised and push the button **sychronize now** -* After the first successful synchronisation is complete, you can close the window. Henceforth, TbSync will do the work for you. You are done and can skip the next sections (unless you need a more advanced address book) +* Enter an **account name** (which you can freely choose), a **user name**, a **password**, the **URL of your server**, and click **next** +* In the next window, TbSync should have auto-discovered the CalDAV and CardDAV addresses. When it has, click **Finish** +* Check the **Enable and synchronize this account** box. TbSync will now discover all address books and calendars your account has access to on the server +* Check the box next to each calendar and address book you want to have synchronized, set how often you want them to be synchronized, and push the button **synchronize now** +* After the first successful synchronization is complete, you can close the window. + +Henceforth, TbSync will do the work for you. You are done with the basic configuration and can skip the next sections unless you need a more advanced address book. Alternative: Using the CardBook add-on (Contacts only) ------------------------------------------------------ + `CardBook `_ is an advanced alternative to Thunderbird's address book, which supports CardDAV. You can have TbSync and CardBook installed in parallel. -1. Click the CardBook icon in the upper right corner of Thunderbird: +#. Click the CardBook icon in the upper right corner of Thunderbird: -.. image:: ../images/cardbook_icon.png + .. image:: ../images/cardbook_icon.png -2. In CardBook: +#. In CardBook: - - Address book > New Address book **Remote** > Next + - Go to Address book > New Address book **Remote** > Next - Select **CardDAV**, fill in the address of your Nextcloud server, your user name and password -.. image:: ../images/new_addressbook.png + .. image:: ../images/new_addressbook.png -4. Click on "Validate", click Next, then choose the name of the address book and click Next again: +#. Click on "Validate", click Next, then choose the name of the address book and click Next again: -.. image:: ../images/addressbook_name.png + .. image:: ../images/addressbook_name.png -5. When you are finished, CardBook synchronizes your address books. You can always trigger a synchronisation manually by clicking "Synchronize" in the top left corner of CardBook: +#. When you are finished, CardBook synchronizes your address books. You can always trigger a synchroniZation manually by clicking "Synchronize" in the top left corner of CardBook: + + .. image:: ../images/synchronize_cardbook.png -.. image:: ../images/synchronize_cardbook.png The old method: Manually subscribing to calendars ------------------------------------------------- + This method is only needed if you don't want to install TBSync. -1. Go to your Nextcloud Calendar and click on the 3 dotted menu for the calendar that you want to synchronize which will display an URL that looks something like this: +#. Go to your Nextcloud Calendar and click on the 3 dots menu for the calendar that you want to synchronize which will display an URL that looks something like this: ``https://cloud.nextcloud.com/remote.php/dav/calendars/daniel/personal/`` -2. Go to the calendar view in Thunderbird and right click in the calendar menu to the left (where the names of the calendars are) to add a **New Calendar**. +#. Go to the calendar view in Thunderbird and right-click in the calendar menu to the left (where the names of the calendars are) to add a **New Calendar**. -3. Choose **On the Network**: +#. Choose **On the Network**: -.. image:: ../images/new_calendar.png + .. image:: ../images/new_calendar.png -4. Choose **CalDAV** and fill in the missing information: +#. Choose **CalDAV** and fill in the missing information: -.. image:: ../images/CalDAV_calendar.png + .. image:: ../images/CalDAV_calendar.png