Waldur Docker-compose deployment
- at least 8GB RAM on Docker Host to run all containers
- Docker v1.13+
1 2 3 4 5
1 2 3 4 5 6 7 8 9 10 11 12
Healthcheck can be accessed on http://localhost/health-check.
Tearing down and cleaning up:
Logs emitted by the containers are collected and saved in the
waldur_logs folder. You can change the location by
editing environment variable (
.env) and updating
When Waldur is launched for the first time, it applies initial database migrations. It means that you may need to wait few minutes until these migrations are applied. Otherwise you may observe HTTP error 500 rendered by REST API server. This issue would be resolved after upgrade to Docker Compose 1.29.
This setup supports following types of SSL certificates:
- Email - set environment variable TLS to your email to register Let's Encrypt account and get free automatic SSL certificates.
- Internal - set environment variable TLS to "internal" to generate self-signed certificates for dev environments
- Custom - set environment variable TLS to "cert.pem key.pem" where cert.pem and key.pem - are paths to your custom certificates (this needs modifying docker-compose with path to your certificates passed as volumes)
Custom Caddy configuration files
To add additional caddy config snippets into the caddy virtual host configuration add .conf files to config/caddy-includes/
Keycloak is an Identity and Access Management software bundled with waldur-docker-compose.
To create a keycloak admin account run:
Login to the admin interface at https://localhost/auth/admin and create Waldur users