README.md

Nextcloud role

Deploy Nextcloud Docker container.

Usage

Configure the role.

# https://hub.docker.com/_/nextcloud/
nextcloud_image: nextcloud:27-apache
nextcloud_build_image: true # default: false
nextcloud_hostname: nextcloud01
nextcloud_volume_name: nextcloud_data01 # default: "{{ nextcloud_hostname}}"
nextcloud_volume_backup_set: # See restic_backup_set var in role restic
nextcloud_domain: nextcloud.example.com
nextcloud_trusted_domains: nextcloud.example.com # default: "{{ nextcloud_domain }}"
nextcloud_admin_user: admin
nextcloud_admin_password: # default: "{{ vault_nextcloud_admin_password }}"
nextcloud_postgres_hostname: postgres01
nextcloud_postgres_user: nextcloud # default: "{{ postgres_user }}"
nextcloud_postgres_password: # default: "{{ vault_postgres_password }}"
nextcloud_postgres_db: nextcloud
nextcloud_mail_hostname: mail.example.com
nextcloud_mail_encryption: tls
nextcloud_mail_port: "587"
nextcloud_mail_from: noreply@example.com
nextcloud_mail_username: bot@example.com
nextcloud_mail_password: "{{ vault_nextcloud_mail_password }}"
nextcloud_redis_hostname: redis01
nextcloud_redis_password: "{{ vault_nextcloud_redis_password }}"
nextcloud_etc_hosts: # defaults: {}
  "doc.example.com": 10.42.5.2

And include it in your playbook.

- hosts: nextcloud
  roles:
  - role: nextcloud

Docs

Use MySQL/MariaDB database

Configure these vars to make a connection to a MySQL/MariaDB database:

nextcloud_mysql_hostname: mysql01
nextcloud_mysql_user: nextcloud # default: "{{ mysql_user }}"
nextcloud_mysql_password: # default: "{{ vault_mysql_password }}"
nextcloud_mysql_db: nextcloud

Add Redis config manually

In case the Redis container is deployed after Nextcloud has been initated, the config below must be added to the config.php to enable Redis caching.

'memcache.distributed' => '\OC\Memcache\Redis',
'memcache.locking' => '\OC\Memcache\Redis',
'redis' => [
     'host' => 'nextcloud_redis_hostname',
     'password' => 'nextcloud_redis_password',
     'port' => 6379,
],

Build manually

Copy the build files with Ansible.

Build with Docker.

cd /srv/build/nextcloud01
docker build . -t nextcloud:nextcloud01

Internal Server Error

When Nextcloud is thowing an Internal Server Error without details in the log, run the occ cli to get details on the issue.

docker exec --user www-data nextcloud01 php occ

Exit maintenance mode

Disable the maintenance mode with the occ cli.

docker exec -u www-data -it nextcloud01 php occ maintenance:mode --off