Create a demo site for your Docker based web application.
Live Demo (Arcane): https://demo.getarcane.app/start-demo
- Quickly create a demo for your project.
- Spin up a temporary Arcane demo when requested, then shut it down automatically.
- A countdown timer and copyable login credentials at the bottom right corner.
- 10 minute demo sessions by default, reaped early once idle.
- Concurrency cap and per-IP rate limit so one visitor can't exhaust the host.
- Portless demo instances design in v2, you just need one port for Demo Kuma.
- Create a stack directory
demo-kuma. - Download
compose.yamlandcompose-demo.yamlinto the directory.
compose.yaml= Demo Kuma stack- You should go through all variables in the
environment:section.
- You should go through all variables in the
compose-demo.yaml= The stack that you want to provide a demo (Arcane)- By default, the main service should be
main. - If you run the stack with a different project name, set
DOCKER_NETWORK_NAMEto match that network (e.g.,{project}_default).
- By default, the main service should be
- Start the stack:
On first boot, Demo Kuma will generate
docker compose up -d --build
ENCRYPTION_KEYwithopenssl rand -base64 32automatically and persist it in/app/runtime. It is passed to each demo instance asARCANE_ENCRYPTION_KEY. - If you are running behind a public domain, set
APP_URLto the public origin before starting the stack. - Go to http://localhost:3003/start-demo to test the demo.
All settings are environment variables in compose.yaml, where each one is
commented. Worth knowing:
SESSION_TIME(600) — hard cap on a session, in seconds.SESSION_IDLE_TIMEOUT(120) — idle seconds before a session is reaped. Keep it above 60s: browsers throttle background-tab timers to about one tick a minute.MAX_SESSIONS(10) — concurrent stacks. Over the cap, visitors get a "demo is busy" page instead of a new stack.START_RATE_LIMIT_MAX/START_RATE_LIMIT_WINDOW(2 / 600) — per-IP start budget. Override these locally, where every request shares one address.TRUST_PROXY(false) — take the client IP fromX-Forwarded-For. Enable only when this runs behind a reverse proxy you control.IMAGE_REFRESH_INTERVAL(900) — seconds between background pulls of thecompose-demo.yamlimages, so new sessions run the latest Arcane.APP_URL— the public origin. Required. Passed to each demo instance asARCANE_APP_URL.
compose-demo.yaml uses dhi.io/docker-dind:29-alpine (a Docker Hardened
Image). dhi.io refuses anonymous pulls. The pulls run through the docker CLI
inside the Demo Kuma container, so the login has to be in a docker config that
container can read. compose.yaml mounts ./private/docker-config (gitignored)
at /root/.docker.
- Create a Docker Hub personal access token with read-only scope.
- Log in, saving the login into that directory:
docker --config ./private/docker-config login dhi.io -u <dockerhub-user>
- Restart the stack:
docker compose up -d.
Store the login in the file, not in a credential helper (credsStore). The
container has no helper binary.
GET /healthz reports session count and Docker reachability, and backs the
container healthcheck.

