dynamicweb/DOCKER.md

Running dynamicweb with Docker Compose

A self-contained test/dev stack: Postgres, Redis, the web app and a Celery worker. Nothing else needs to be installed on the server.

Start

git clone <this repo> && cd dynamicweb
docker compose up -d --build
docker compose logs -f web      # wait for "Starting development server"

The first start takes a few minutes: it builds the image, creates the database, runs all migrations and generates a Django secret key (kept in the appdata volume).

The app listens on port 8000. Open it at http://<server-ip>:8000/ (open the port in the server firewall if needed).

Configuration

• Defaults for everything are in .env.docker (committed, dev values only).
• To override a value, create a .env file next to docker-compose.yml (optional, git-ignored). Values there win over .env.docker.

Using your own Postgres instead of the bundled one

Set the connection in .env:

POSTGRES_HOST=<host>
POSTGRES_PORT=5432
POSTGRES_DB=<db>
POSTGRES_USER=<user>
POSTGRES_PASSWORD=<password>

then start everything except the bundled database:

docker compose up -d --build --no-deps web celery redis

Testing all the sites

The project serves many websites from one app and chooses the site from the hostname. In this test setup you don't need DNS or /etc/hosts: a dev-only switcher picks the site from ?site=<domain> and remembers it in a cookie.

Open /dev-sites/ on any host for a page of clickable links (http://<server-ip>:8000/dev-sites/). On a machine running the stack locally:

Site	Link
ungleich.ch	http://localhost:8000/?site=ungleich.ch
blog.ungleich.ch	http://localhost:8000/?site=blog.ungleich.ch
comic.ungleich.ch	http://localhost:8000/?site=comic.ungleich.ch
digitalglarus.ch	http://localhost:8000/?site=digitalglarus.ch
datacenterlight.ch	http://localhost:8000/?site=datacenterlight.ch
rails-hosting.ch	http://localhost:8000/?site=rails-hosting.ch
django-hosting.ch	http://localhost:8000/?site=django-hosting.ch
node-hosting.ch	http://localhost:8000/?site=node-hosting.ch
devuanhosting.ch	http://localhost:8000/?site=devuanhosting.ch
devuanhosting.com	http://localhost:8000/?site=devuanhosting.com
ipv6onlyhosting.com	http://localhost:8000/?site=ipv6onlyhosting.com
digitalezukunft.ch	http://localhost:8000/?site=digitalezukunft.ch
hack4glarus.ch	http://localhost:8000/?site=hack4glarus.ch
xn--nglarus-n2a.ch	http://localhost:8000/?site=xn--nglarus-n2a.ch

Use ?site= (empty) to clear the choice. To add a site, add it to UNGLEICH_SITE_CONFIGS in .env.docker (a Site row is created on start).

Loading data (optional)

The database starts empty, so the sites are mostly blank. To load a dump, put a plain-SQL *.sql or *.sql.gz file in db-init/ before the first start; Postgres restores it automatically. To reload: docker compose down -v (this deletes the volumes) and start again. Dumps are git-ignored because they contain personal data.

Useful commands

docker compose ps                         # what is running
docker compose logs -f web celery         # logs
docker compose up -d --build              # rebuild after code changes (code is baked into the image)
docker compose exec web python manage.py createsuperuser
docker compose down                       # stop (keeps data); add -v to wipe it

Limitations of the test setup

OpenNebula (VM creation), LDAP login and Stripe payments use placeholders and will not work. Email is printed to the web container log. DEBUG=True is on.