somatorio/pretalx repository overview

⁠pretalx-docker

This repository contains a docker-compose setup as well as an ansible⁠ role for a pretalx⁠ installation based on docker.

Please note that this repository is provided by the pretalx community, and not supported by the pretalx team.

⁠Installation with docker-compose

⁠For testing

• Run docker-compose up -d. After a few minutes the setup should be accessible at http://localhost/orga⁠
• Set up a user and an organizer by running docker exec -ti pretalx pretalx init.

⁠For production

• Edit conf/pretalx.conf and fill in your own values (→ configuration documentation⁠)
• Edit docker-compose.yml and remove the complete section with ports: - "80:80" from the file (if you go with traefic as reverse proxy) or change the line to ports: - "127.0.0.1:8355:80" (if you use nginx). Change the database password.
• If you don't want to use docker volumes, create directories for the persistent data and make them read-writeable for the userid 999 and the groupid 999. Change pretalx-redis, pretalx-db and pretalx-data to the corresponding directories you've chosen.
• Configure a reverse-proxy to handle TLS. Pretalx listens on port 80 in the pretalxdocker network. I recommend to go with traefik for its ease of setup, docker integration and LetsEncrypt support⁠. An example to copy into the normal compose file is located at reverse-proxy-eamples/docker-compose. You can also find a few words on an nginx configuration at reverse-proxy-eamples/nginx
• Run docker-compose up -d . After a few minutes the setup should be accessible under http://yourdomain.com/orga⁠
• Set up a user and an organizer by running docker exec -ti pretalx pretalx init.

⁠Installation with ansible

(Please note that we also provide a second ansible role for use without docker here⁠).

⁠For testing

• Add the role at ansible-role to your ansible setup.
• Roll out the role
• You should be able to reach pretalx at http://localhost/orga
• Set up a user and an organizer by running docker exec -ti pretalx pretalx init.

⁠For production

• Add the role at ansible-role to your ansible setup.
• Fill in the variables listed in the vars/main.yml file. Make sure to set testing to false!
• Set up a reverse proxy to handle TLS. traefik is recommended. The containers that get rolled out are already tagged for traefik. An example role for traefik is included at reverse-proxy-eamples/ansible/traefik.
• Roll out the role. After a few minutes pretalx should be reachable at the configured domain.
• Set up a user and an organizer by running docker exec -ti pretalx pretalx init .