Ansible Role: Nextcloud

This role installs and updates Nextcloud and its apps. That's all it does; it doesn't set up a web server or a database.

Features

With this role, you can:

• Install, update, and configure the main Nextcloud application.
• Install, update, and configure Nextcloud apps from the app store.
• Create and manage users and groups.

Requirements

Ansible version 2.7 or higher is needed.

There are other roles out there that can install Nextcloud, but they often try to do too much at once, like setting up Apache and MySQL before installing Nextcloud. This can be quick for some users but doesn’t offer enough flexibility.

This role focuses solely on Nextcloud. It downloads, installs, and configures it without making assumptions about your setup. It is meant to work alongside other roles. If you encounter any issues or missing features, please report them. Currently, it has only been tested on Ubuntu 16.04.

For a look at how to create a complete setup with third-party roles, check the Example playbook.

If you want to import feeds into the News app from an opml file, make sure to install the Python listparser module:

pip install listparser

Versions

• Supported Nextcloud versions: This role will support all officially supported Nextcloud versions from 14 onwards. Versions older than 14 won’t be supported. Each new major version of Nextcloud will update the default version this role installs.

• Supported Ansible versions: The role is developed using a daily version of Ansible from their development branch. A new role release will be made with every new stable version of Ansible (currently 2.7). Future work will follow the next in-development version of Ansible.

Role releases will have names like v14-2.7-1.0, where:

• 14 is the default Nextcloud version installed
• 2.7 is the compatible Ansible version
• 1.0 is the role's version number, which resets when either previous components are updated

The release will also work with later Ansible versions compatible with 2.7.

Role Variables

For a complete list of variables and how to use them to configure this role, check defaults/main.yml.

Example Playbook

For a working example of how to use this role with others for a complete Nextcloud server setup, see molecule/default/prepare.yml and molecule/default/playbook.yml.

License

GPLv3

Author Information

Nikolaos Kakouros