Examples
Common patterns for Launchfiles — from minimal to multi-component. Each example is a complete, valid Launchfile you can use as a starting point.
Want to learn by building? The Learn Launchfile course walks you through each concept step by step.
Minimal
Three fields plus a start command — the simplest possible Launchfile.
Minimal with Database
Single component with Postgres and a health check.
Single Component
Full-featured with services, env vars, and lifecycle commands.
Multi-Component
HedgeDoc with backend/frontend and inter-component wiring.
Prebuilt Image
Deploy from an existing OCI/Docker image.
Cron Job
Scheduled task on a cron schedule, no persistent process.
Host Capability (Container Runtime)
Request the host's container runtime with a host: entry — granted or refused, wired via $socket / $url / $api.
Host Orchestrator
Several host capabilities at once — container runtime, host network, and host filesystem.
Local Dev (Source Mode)
Run from source with install / dev — launchfile dev, no container.
Storage Paths
Reference a provisioned volume's path with $storage.<name>.path — portable across providers.