mash-playbook/docs/services/nextcloud.md
2023-03-17 11:44:27 +02:00

2.1 KiB

Nextcloud

Nextcloud is the most popular self-hosted collaboration solution for tens of millions of users at thousands of organizations across the globe.

Dependencies

This service requires the following other services:

Configuration

To enable this service, add the following configuration to your vars.yml file and re-run the installation process:

########################################################################
#                                                                      #
# nextcloud                                                             #
#                                                                      #
########################################################################

nextcloud_enabled: true

nextcloud_hostname: mash.example.com
nextcloud_path_prefix: /nextcloud

########################################################################
#                                                                      #
# /nextcloud                                                            #
#                                                                      #
########################################################################

In the example configuration above, we configure the service to be hosted at https://mash.example.com/nextcloud.

You can remove the nextcloud_path_prefix variable definition, to make it default to /, so that the service is served at https://mash.example.com/.

Usage

After installation, you should follow Nextcloud's setup wizard at the URL you've chosen.

You can choose any username/password for your account.

In Storage & database, you should choose PostgreSQL (changing the default SQLite choice), with the credentials you see after running just run-tags print-nextcloud-db-credentials

Once you've fully installed Nextcloud, you'd better adjust its default configuration (URL paths, trusted reverse-proxies, etc.) by running: just run-tags adjust-nextcloud-config