10 KiB

Executable File

Raw Blame History

title

visible

updated

page-toc

published

taxonomy

Nextcloud Desktop client

false

last_modified	app	app_version
July 2019	Nextcloud Desktop	2.5

active
true

true

`Meta information`
`This howto was last updated on` 06-04-2019 `and it reffers to:` Nextcloud Desktop sync client: version - 2.5.2git Nautilus-Nextcloud integration plugin - 2.5.0-1 AUR

Installing Nexcloud client

You can download and see how to install the Nextcloud desktop app here.

Ubuntu and / or Ubuntu based distributions users can find better detailed instructions here.

Add a new account

The first time you run the Nextcloud desktop client you will be directly greeted with the account setup:

Select: Log in
Server Address: cloud.disroot.org
Press: Next

There are two ways of doing it:

App Password (for Two Factor Authentication)
Normal Credentials

App Password (Two Factor Authentication)

If you have enabled Two-Factor Authentication (2FA) in your Disroot Cloud, then you need to:

Generate an "App Password", in the Security section of your Disroot Cloud account web interface, to generate a specific App Password for the Nextcloud desktop client. You can read about how to do that here.

Once you have your App Password token created and copied, in the login menu:

Select: "Alternative login using app token"
Username: your_disroot_account_username
App Token: Paste the App Token you created
Press: Grant Access

Normal Credentials

If you do not have 2FA enabeled then just:

Press the Log in button
Username: your_disroot_account_username
Password: your_super_secret_password
Press the Log in button again
Then press "Grant Access"

Configuring a sync folder

Final step in adding a new account is to configure the sync folder. After you successfully log in you will be prompted with a options panel where you can:

Select what folders to sync from your Disroot Cloud to your machine, by pressing "Choose what to sync"
Set a limit to not sync any file above a certain size you decided (this can be changed later at any point).
Authorize if you also want to sync External Storage's (you can know more about External Storage's here)
Change the destination folder where your files will be synced in your hard drive (The Nextcloud Desktop Client will by default create a folder called "Nextcloud", in your home folder).

Once you are happy with the settings, just hit "Connect" at the lower left corner of the menu.

Any file you edit in the local folder in your machine (.txt, spreadsheet, word) will be synced with your Disroot Cloud. Any files you remove or add will be removed or added in your Disroot Cloud. Any change done from the interface will reflect your synced folder on your desktop, unless you opted out from synchronizing a particular file or folder.

General options

Nextcloud client opens by default in the background. By interacting with Nextcloud systray icon you can focus the app.

The app consists of 4 main tabs:

Your account tab
Activity tab
General tab
Network tab

Your account tab

Gives you a general overview of what's the current status of your app.

You can:

See the status of any synchronization, and remaining disk space on your Disroot Cloud account

Choose what folders to sync or stop syncing by clicking in the checkbox option. You will need to press the Apply button on the lower right corner of the window for the changes to take effect

Confirm the signature of the ssl keys by pressing the padlock button

Pause/Restart synchronization
Open the desktop folder where your files are
Remove folder

All by pressing the three dotted button

Add a new account
Remove account
Logout

All by pressing the "Account" button on the upper right side of the window

Adding multiple accounts

Nextcloud desktop client works with multiple accounts. You aren't even restricted to only Disroot accounts either. You can add any Nextcloud account from any other server (including your own server, of course).

Adding an extra account is the same process as adding the first one. In the "Account" button:

Press "Add new"
Follow the same steps as you did to register the first account (adjust the URL's if it's a different server)

NOTE: The important thing to keep in mind. You can't use the same Nextcloud folder with multiple active accounts.
During the configuration process of a second account, Nextcloud client will create in your home folder a folder called Nextcloud2". Keep and eye out for this.

After you add a second account your, 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.

You will also see one separate Activity tab for each account.

Activity tab

Activity tab gives you an overview on all the uploaded/downloaded/added/removed files and folders from your accounts. Similar to Activity app in Disroot cloud interface.

General tab

General tab lets you:

Set the limit for files sizes that you download to you local folder
Set if the client should ask permission to sync External Storage's
Set to show notifications on your desktop
Launch Nextcloud Desktop Client when the system starts
See legal notice and if there are any updates

Edit Ignored Files Some files are ignored by default, and not synced by Nextcloud Desktop Client. For example hidden files or files that the name starts with: "~/", "."

If this affects you, you can change this by:

Pressing the button "Edit Ignored Files"
Press the option "Sync hidden files" (if you want to sync all hidden files)
Press the checkbox options to edit manually what files to allow to sync
To add new rules for files to ignore press "Add"
At the end press "ok"
You can set the rules back to the original setting by pressing "Restore Defaults"

Network tab

The Network tab allows you to:

Configure your nextcloud desktop client for your proxy settings (if you are using a proxy)
Set maximum download and upload bandwidth

Nextcloud desktop client allows integration, with some GNU/Linux file managers, allowing you to share a file without needing to open the web interface of your Disroot Cloud account.

Supported file managers at this moment are:

Nautilus
Nemo
Caja
Dolphin

For the first three file managers you'll need to install:

The Nextcloud-client-nautilus plugin. The name of it might be different in some GNU/Linux distributions, e.g in Arch Linux it's nextcloud-nautilus.
The python-nautilus dependency.

KDE/Dolphin file manager users must install the Dolphin plugin for Nextcloud.

This integration allows you to:

Create Share links of files or folders
Manage those share links
- Delete them
- Set expiry date
- Set a password to open the link
- Share directly with other users or groups (if you know their usernames, or group name)

To create a share link go to the Nextcloud folder on your machine with the file or folder you want to share.

Once you copied the link just send it via email, or some other way.

To share directly with another user or group of Disroot Cloud (if you the persons username, or the group name) Just:

Write the username or group name in question in the text box
Press the arrow button on the right side of the text box

And you will see in the button of the window information regarding that particular share.

And manage the share with the user in question:

Deleting the share
Allow re-sharing
Allow editing

You can manage these shares you create from your file manager at any time by the same process you used to originally create the share:

Right clicking on the file or folder
Select the nextcloud option
And press share

File status icon

With file manager integration, the file manager generates icons on the folders and files inside your nextcloud folder. This allows you to quickly see which files and folders where: