Howto/pages/02.tutorials/02.Cloud/05.Clients/01.Desktop/01.Multiplatform/00.desktop-sync-client/docs.en.md
2021-01-12 13:47:50 -03:00

201 lines
9.6 KiB
Markdown
Executable file
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: 'Nextcloud Desktop Client'
visible: false
updated:
last_modified: "January 2021"
app: Nextcloud Desktop Client
app_version: 3.0.3-2 on Manjaro Linux
page-toc:
active: true
published: true
taxonomy:
category:
- docs
tags:
- cloud
- nextcloud
- client
- multiplatform
---
# Nextcloud Desktop Client
Using the **Nexcloud** desktop client provides a way to sync your files stored in your **Disroot Cloud** with a local folder on your computer desktop.
This means you can access/add/remove/edit the files in your **Cloud** from your desktop without the need to log in to your account via web-browser. It also allows you to access them when offline.
---
# Installing the Nextcloud client
The client is already available to install from the Software manager of the following **GNU/Linux** distributions:
- **openSUSE Tumbleweed**
- **Arch Linux** (and distributions based on it)
- **Fedora**
To install it on **Debian/Ubuntu** (and distributions based on it) users can find detailed instructions [**here**](https://launchpad.net/~nextcloud-devs/+archive/ubuntu/client).
To learn how to install the client in other distributions and operating systems, you can check this [**page**](https://nextcloud.com/install/#install-clients).
# Add a new account
The first time you run the **Nextcloud** client an installation wizard will open guiding you through the account setup and some configuration options:
1. Select **Log in**
2. Enter the Server Address: **https://cloud.disroot.org**
3. Press **Next**
4. To connect your account press **Log in**
5. Enter your **Disroot** username and password and **Log in** again
6. **Grant access** to the app
7. Once the client is connected you can close the browser
8. Now you can setup your local cloud folder (we will see this below)
![](en/nextcloud_client_wizard.mp4?resize=1024,602&loop)
## Two-Factor Authentication login
In case you have enabled the **Two-Factor Authentication (2FA)** method to log in to your **Disroot Cloud**, you will need to enter the code generated by the [**OTP**](https://en.wikipedia.org/wiki/One-time_password) application you use to do so when you configure the **Nexcloud** client and it request access permission:
![](en/2fa_login.png)
You can read about what it is and how to enable **Two-Factor Authentication** [**here**](https://howto.disroot.org/en/tutorials/cloud/settings#two-factor-authentication).
## Setting up a local folder
Now the final step in adding a new account is to configure the **sync folder** (the local folder where the files you have in the cloud will be synchronized).
![](en/local_folder_options.png)
On the local folder options screen you can choose to sync all of your files on the **Disroot Cloud** or select specific folders. The default local sync folder is `Nextcloud`, in your home directory. You can also change it for the folder you want or create a new one.
There are five options in this screen:
1. By default, the client will try to **Sync everything** on the server. You can also see how much data (measured in MB or GB) you have in your cloud. If you want to sync only specific files or folders, select **Choose what to sync** (4)
2. Set a limit to not sync any file above a certain size you decided (this can be changed later at any point).
3. Set to ask for authorization if you want to sync external storages (to know more about External Storage go [**here**](https://howto.disroot.org/en/tutorials/cloud/settings#external-storages))
4. Select what folders to sync from your **Disroot Cloud** to your machine, by pressing **Choose what to sync**
5. And select or change the local folder by clicking the Local Folder button.
![](en/local_folder_setup_2.png)
Once you have selected the folder to sync press **OK** and then **Connect...**
![](en/local_folder_setup_3.png)
The wizard will close and the client will start synchronizing files and folders (if any) minimized in the desktop task tray.
![](en/local_folder_setup.mp4?resize=1024,602&loop)
From the desktop client interface you can access:
![](en/desktop_client.png)
* To a minimal menu from where you can add or remove an account, pause/resume a sync, access the client settings, log out from an account or exit the client by clicking on the down arrow at the right of your username.
* Your local folder (1)
* The **Talk** app (2)*
* The **Apps** (3)*
\* **Talk** and **Apps** will be opened in the browser.
From now on, any file you edit in the local folder on your machine (texts, spreadsheets, pictures, etc) will be synced with your **Disroot Cloud**. So whether you modify, add or remove files in this folder, they will also be modified, added or removed from your **Cloud**. The same will happen with the modifications you make through the web interface and they will be reflected in your local folder, unless you have chosen not to sync a particular file o folder.
## Adding multiple accounts
**Nextcloud** desktop client can work with multiple accounts. You can add any **Nextcloud** account from any other server (including your own server, of course).
To add an extra account the process is the same as the first one.
![](en/add_account.png)
1. Click on the **Nexcloud** client icon in the system tray
2. Select **"Add account"**
3. Follow the same steps as you did to register the first account (you will need to adjust the server address if it is a different server)
!! **NOTE**<br>
!! Keep in mind that **you cannot use the same Nextcloud folder** with multiple active accounts.<br>
!! During the configuration process of the second account, **Nextcloud** client will try to create a folder called **Nextcloud2"** in your home directory. Keep an eye to this.
After you add a second account, it will show up on the top bar of the app. This is how you also switch between accounts if you need to change settings.
# Settings
![](en/client_settings_1.png)
To access the **Nextcloud** client settings just right click on the app icon in the tray and select **Settings**.
![](en/client_settings_access.png)
The **Settings** are divided in three main tabs:
1. [Account Settings tab](#account-settings)
2. [General tab](#general-tab)
3. [Network tab](#network-tab)
![](en/client_settings_tabs.png)
## Account Settings tab
It gives you a general overview of the connected accounts, the synced folders and some options to manage them.
![](en/account_settings_tab.png)
1. **Connected to**<br>
Indicates the **Nextcloud** server which the client is syncing with, the user account on that server and the signature of the [**SSL keys**](https://en.wikipedia.org/wiki/Public_key_certificate) (you can check it by pressing the green lock icon)
![](en/signature.png)
2. **Storage usage**<br>
It provides details on the storage used on your **Cloud** account.
3. **Synchronization options**<br>
Here you can choose what folders to sync or stop syncing by clicking in the checkbox option and then pressing the **Apply** button on the lower right corner of the window for the changes to take effect.
By clicking the three dots button you can:
![](en/sync_options.png)
- Open the local folder
- Edit Ignored files: click this option to make a list of files which will not be synced between the client and server.
![](en/ignored_files.png)
This option allows you to add patterns for files or directories that you do not want to be included in the sync process. You can use normal characters, wild cards (an asterisk * to indicate multiple characters) or a question mark ? (to indicate a single character).
- Force/Pause synchronization
- And remove a selected folder from being synced. This is useful if, for example, you want to sync only one or some folders and not the entire root directory.
4. **Add Folder Sync Connection**<br>
You can add another folder to the sync by clicking this button and then selecting the folder on the server to sync with. Keep in mind that the directory and the alias name must be unique, because a server folder can only sync to the client one time. So, if, for example, the sync is to the server root directory it will not be possible to select another folder under the root to sync.
## General tab
![](en/general_tab.png)
In the **General** tab there are three sections:
1. The **General Settings** section where you can:
- Set whether or not to launch the **Nextcloud** client when the system starts
- Set monochromatic icons on the system tray
- Show (or not) server notifications on the desktop that requires attention
2. The **Advanced** section where you can:<br>
- **Edit Ignored Files**: This option works almost the same way as the one on the **Account settings tab**. The client ignores by default some files that are not synced. For example, hidden files or files which their names starts with `~/` or `.`<br> If you need to change this:<br>
a. Press this **Edit Ignored Files** button<br>
b. Then select the **Sync hidden files** option (if you want to sync all hidden files)<br>
c. Press the checkbox options to edit manually what files to allow to sync<br>
d. Click on **Add** to add new rules for files to ignore<br>
e. And finally press **OK** when you are done<br>
f. You can also set the rules back to the original setting by pressing **Restore Defaults**<br>
![](en/ignored_files_editor.png)
- Set a size limit for files that you download to your local folder
- Set if the client should ask permission to sync External Storages
3. The **About** section where you can see the client version and the legal notice
## Network tab
![](en/network_tab.png)
Finally, through this tab you can:
- Configure the proxy settings for your **Nextcloud** client (if you are using a proxy)
- And set bandwidth limits for download/upload