Prerequisites
Everything you need before running docker compose up.
Requirements
| Requirement | Details |
|---|---|
| Docker Engine | v24 or later with Docker Compose v2 (docker compose subcommand). |
| Git | To clone the repository. |
| 2 GB+ free RAM | PostgreSQL, MinIO, Temporal, frontend, and worker all run simultaneously. |
The Docker Compose stack bundles PostgreSQL, MinIO (S3), and Temporal — you do not need to install them separately.
Secrets to generate
Yardrail requires several secrets. Generate them before starting the stack:
# PostgreSQL password
openssl rand -hex 16
# JWT signing secret (session tokens)
openssl rand -hex 32
# Credential encryption key (AES-256-GCM, secrets at rest)
openssl rand -base64 32
# MinIO root password (also used as the S3 secret key)
openssl rand -hex 16
# Temporal payload encryption key (format: id:base64key)
echo "key1:$(openssl rand -base64 32)"
# Interlink service token (worker ↔ frontend auth)
openssl rand -hex 32
These are written to a .env file during installation — see the
install guide.
Docker socket access
The worker creates CWL tool containers on the host's Docker daemon. This requires the Docker
socket (/var/run/docker.sock) to be bind-mounted into the worker container. The default
docker-compose.yml does not include this mount — the install guide covers adding it via an
override file.