Skip to main content

Prerequisites

Everything you need before running docker compose up.

Requirements​

RequirementDetails
Docker Enginev24 or later with Docker Compose v2 (docker compose subcommand).
GitTo clone the repository.
2 GB+ free RAMPostgreSQL, 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.

Next steps​

Install with Docker Compose →