continuous-integration/drone/push Build is passing
Details
Reviewed-on: #10 |
||
---|---|---|
defaults | ||
handlers | ||
tasks | ||
templates | ||
.drone.yml | ||
.yamllint | ||
LICENSE | ||
README.md | ||
renovate.json |
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