From WebarchDocs
Jump to navigation Jump to search

See our Nextcloud page for virtual server hosting packages; our Nextcloud servers are built and configured using the Ansible Playbooks on

The Nextcloud discourse support forum has lot of additional advice.

We also have a Nextcloud command line page for help on use of the CLI.

First Steps

When Nextcloud is installed an admin account is created, we suggest that this account is only used for administration purposes and not for file sharing etc.

So the first thing you need to with your new Nextcloud server is create additional user accounts, we suggest one per person and that you start by adding a user account for yourself.

Add user groups and accounts

To do this you need to login:

The Nextcloud login screen

The access the admin menu using the top right hand corner A icon (A being the first letter of admin, this can be updated to an image by uploading a logo via the profile settings) in order to add other user accounts:

Access the Nextcloud admin menu

Before you add users you probably want to create groups for the users, you can do this using the Add Group link at the top left of the screen:

Access the Nextcloud add group form

Click Add Group and a form appears:

Form to enter the new Nextcloud group name

Type the new group name into the form field and click the tick to create the group:

Enter the new Nextcloud group name

Then you can use the Add User form fields to add a user and select their group(s) at the same time:

Add a user to Nextcloud

You can also optionally make users admins for groups:

Make a user a group admin

Then you need to let your users know that accounts have been created for them. Let them know their passwords and usernames and the URL of your Nextcloud server, and then ask them to login and setup their profile. The most important field they need to fill in is their email address. It would also be good practice for them to change their passwords at this point.

Before you do this you should probably do it for yourself; logout of the admin account and login using the new account you have created.

Login and update your profile

To login to a Nextcloud server when you have your username and password, first go to the URL of the server and login:

The Nextcloud login screen

Then to access the user profile click the user icon at the top right hand corner of the screen:

Access the settings form

Then enter your details:

Enter your user profile details

Desktop and mobile clients

Once you have a Nextcloud account and you have set your profiles details, the next thing to do is to install a client. To do this visit the Nextcloud install page, and select Desktop Clients or Mobile Clients depending on your type of device.

Download a Nextcloud client

Collabora Online

Generally it is best to install a Nextcloud app and mount the filesystem, and use local office applications, for example LibreOffice Free Office Suite or an alternative.

However at times, if multiple people need to edit a document at the same time, or if you need access to update documents using only a web browser, then this is where Collabora Online is useful. It allows you to open and edit word processing documents, spreadsheets and presentations from with a web browser.

To use Collabora Online you first need to login to your Nextcloud server:

The Nextcloud login screen

And then select the files icon at the top left:

The Nextcloud files icon

Then select a directory (folder) by clicking on its name:

Click on a Nextcloud directory

Then click on a file name to open it in Collabora Online:

Click on a Nextcloud file name

And then you can edit and save your document:

Edit a document in Collabora Online

Nextcloud Talk

Advice on the use of Nextcloud Talk to be posted here soon.

JavaScript XMPP Chat

If your Nextcloud has the optional XMPP (Jabber) Prosody server installed and the JavaScript XMPP Chat plugin enabled then you can use the chat facility both within the Nextcloud web interface and with other XMPP clients. We would suggest that you will have a better experience with other clients as they have more features.

By default we setup the Prosody XMPP server with two chatroom domains,; (this is for private chatrooms that are only available to people with accounts on, and; (chatrooms on this domain are open to people with XMPP accounts on other servers).

Examples of XMPP clients:


Conversations, is an XMPP client available for Android from the Play store, Amazon, F-Droid and GitHub.


Gajim, is an XMPP client which available for multiple Linux distros and Windows. If you are running Linux you might simply use the version that is packaged by your distro.


Swift is an XMPP client and is available for Windows, Mac OSX and Linux.


Some common issues:

Login Problems

Sometimes the login screen appears to get stuck, nothing appears to happen:

Nextcloud login screen

This can usually be solved by reloading the page and trying again.

Collabora Online default language

When you edit document using Collabora Online the language for the spellchecker defaults to German. You can change this via Tools > Language > For all Text > English (UK):

Change the Collabora Online document language

When we get an answer for how to change the default language to en_GB we will add this guidance.