Skip to content

Waldur Docker-compose deployment

Prerequisites

  • at least 8GB RAM on Docker Host to run all containers
  • Docker v1.13+

Prepare environment

1
2
3
4
5
# clone repo
git clone https://github.com/waldur/waldur-docker-compose.git
cd waldur-docker-compose
# setup settings
cp .env.example .env

Booting up

1
2
3
4
5
6
7
8
9
# start containers
docker-compose up -d

# verify
docker-compose ps
docker exec -t waldur-mastermind-worker status

# Create user
docker exec -t waldur-mastermind-worker waldur createstaffuser -u admin -p password -e admin@example.com

Waldur HomePort will be accessible on http://localhost. API will listen on http://localhost/api.

Healthcheck can be accessed on http://localhost/health-check.

Tearing down and cleaning up: 

1
docker-compose down

Upgrading Waldur

1
2
docker-compose pull
docker-compose restart

Using TLS

  1. Add private key and certificate to ./certs folder.
  2. Edit docker-compose.yml and replace port section with '80'. This is needed to force HTTP->HTTPS redirect from a TLS proxy: sed -i 's/${WALDUR_INTERNAL_PORT}:80/80/' docker-compose.yml.
  3. Start docker-compose with an extra TLS proxy: 
    1
2
    # start containers
docker-compose up -f docker-compose.yml -f tls-proxy.yml -d
Last update: 2021-05-09