documentation/tools/setting-up-nextcloud.md
2020-07-09 14:20:51 -04:00

2.7 KiB

Setting up Nextcloud for a client

There are several non-intuitive steps to get Nextcloud set up and gotchas which clients have to know about.

It is not possible to add accounts or change passwords in May First's Nextcloud instance, share.mayfirst.org. This must be done in May First's control panel.

Log into May First's control panel with the organization's May First account and create a new User Account to use exclusively for Nextcloud, for instance exampleorg-nextcloud, with a strong password. It is not necessary to provide an e-mail address.

Also here, create user accounts for any people who will be using Nextcloud and do not already have May First accounts (either in the organization or anywhere else— May First accounts are universal across most tools provided by May First, including Nextcloud).

  1. Log into share.mayfirst.org with this new Nextcloud-only account.
  2. Go to Circles
  3. Type a no-spaces version of the clients name (for instance, exampleorg) into the "Create a new circle" box at the top left, under the Nextcloud logo.
  4. For Select a circle type choose "Create a new personal circle".

Ask the people with accounts on May First to use the same username and password to sign into Nextcloud at share.mayfirst.org

Add each of those people to the personal circle (use the same username as they have in the user account in the May First control panel, but they do need to sign into Nextcloud before you can add them).

Under Files on Nextcloud create a folder named after the organization (for instance exampleorg). Share that folder with the personal circle you previously created.

Now every folder you create within that folder will be available to everyone in the organization (the people you added to the circle). And even if a person has multiple affiliations on May First's Nextcloud, the files related to the organization will be clearly namespaced.


  * <https://support.mayfirst.org/wiki/nextcloud>

Rationale

We create an organizaton account so that it's clear people are being invited to organization resources and there is no problem if an individual leaves an organization.

Because the account will have the same password for Nextcloud and for everything else in May First, we create an account through the May First control panel that will be used only for Nextcloud. This way credentials used, even rarely, for logging into Nextcloud are not also used to control web hosting, e-mail, and other