Ansible role for OpenSlides

This role installs OpenSlides.

Requirements

You need to have Docker Compose installed on the target host. We used geerlingguy.docker for that.

Important variables

You can discover all the available variables in the defaults/main.yml file.

The variables openslides_django_secret_key and openslides_admin_password are mandatory. Generate long and secure random values for both of them.

When you execute the playbook and the Git repo on the target host changes, the Docker images get rebuilt. You may want to have control over when that happens. Thus, it is recommended that you set the openslides_repo_version to a fixed commit hash.

By default, connections for all hosts are allowed. Use the openslides_allowed_hosts list to limit access to certain hosts, like:

openslides_allowed_hosts:
  - "{{ openslides_instance_domain }}"

Running behind a reverse proxy

The official docs can show you how to set up HTTPS for OpenSlides.

If you want to use nginx to terminate TLS use the following settings:

openslides_instance_domain: openslides.example.org
openslides_external_http_port: 8000
openslides_external_https_port: ""

Instruct nginx to listen for http2 connections and set up the proxy as follows:

location / {
    proxy_pass http://127.0.0.1:8000;
    proxy_buffering off;
}

License

See LICENSE file