README.md

Openslides

This repository helps to install a small Openslides server for your digital elections and conferences.

The image gets updated and rebuilt every week automatically.

More information on Openslides here

More information on the installation process here (not for smaller/simpler installations)

Prerequisites

• A Linux server with ssh access and Git installed
• A Domain pointing to your server or subdomain (with a DNS entry)
• Container runtime (docker or podman)
• tls certificate files for your subdomain or domain (if you don't have the certificates, you can get them after installing the reverse proxy)

Optional (recommended) prerequisites

• Add a user account to your server (other than root)
• Disable ssh password login to your server

Installation

• First login to your server and clone (download) the git repository with git clone https://gitlab.com/Maxkolbe/openslides.git
• Then change directory into the newly created folder with cd openslides

Installation with docker or podman

Run the openslides container

docker run -d --name openslides \
  --user root:root \
  -p 8000:8000 \
  -v $PWD/settings.py:/root/.config/openslides/settings.py:rw \
  -v $PWD/openslides:/root/.local/share/openslides:rw \
  registry.gitlab.com/maxkolbe/openslides:latest \
  openslides

Run the nginx reverse proxy container

docker run -d --name nginx \
        -p 80:80 \
        -p 443:443 \
        -v $PWD/conf.d:/etc/nginx/conf.d:ro \
        -v $PWD/tls/key.pem:/etc/nginx/cert.key:ro \
        -v $PWD/tls/cert.pem:/etc/nginx/cert.crt:ro \
        -v $PWD/ssl.conf:/etc/nginx/ssl.conf:ro \
        -v $PWD/nginx.conf:/etc/nginx/nginx.conf:ro \
        docker.io/library/nginx:stable-alpine

If you don't have the certificates yet, leave the two -v $PWD/tls/... lines out.

If you have the certificates remove the # from the #include /etc/nginx/ssl.conf line inside conf.d/slides.conf file!