Ansible role to install OpenSlides
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Brain cb88c008de Merge pull request 'Update quay.io/ansible/creator-ee Docker tag to v0.14.1' (#5) from renovate/quay.io-ansible-creator-ee-0.x into main 3 weeks ago
defaults Make repo configurable 9 months ago
handlers First working version 10 months ago
tasks Make repo configurable 9 months ago
templates Always (re)start proxy 6 months ago
.drone.yml Remove blank line 3 weeks ago
.yamllint First working version 10 months ago
LICENSE Update license 10 months ago
README.md Update README 10 months ago
renovate.json Use base config 4 weeks ago

README.md

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