Configuring the playbook

Preparing the inventory and your variables file (vars.yml)

Follow these steps inside the playbook directory:

• create a directory to hold your configuration (mkdir inventory/host_vars/nextcloud.<your-domain>)

• copy the sample configuration file (cp examples/host-vars.yml inventory/host_vars/nextcloud.<your-domain>/vars.yml)

• edit the configuration file (inventory/host_vars/nextcloud.<your-domain>/vars.yml) to your liking. See more in Configuring Services.

• copy the sample inventory hosts file (cp examples/hosts inventory/hosts)

• edit the inventory hosts file (inventory/hosts) to your liking

Configuring Services

Doing the above preparation step, you're all set to proceed to Installing with our default recommended configuration.

However, you may wish to tweak a few other things before installing (or any time later):

• Configuring interoperability with other services (optional)

• configuring the database - if you'd like to use an external Postgres server or another type of database (MySQL, etc) - by default, we install Postgres in a container alongside Nextcloud

• configuring the reverse-proxy - if you'd like to expose your Nextcloud service to the internet using another HTTP webserver - by default, we set up Traefik which will handle ports 80 (http) and 443 (https)

• Storing Nextcloud files on Amazon S3 (no longer available)

• Setting up OnlyOffice integration (optional)

• Setting up Collabora Online (Office) integration (optional)

You may also take a look at the various defaults/main.yml files in roles/ and see if there's anything you'd like to copy over and override in your vars.yml configuration file.

Installing

Once you've configured everything, you can proceed to Installing.

After installation, you can continue changing settings in vars.yml and re-running the installation step to make your server consistent with the configuration.