Recipes
Docker recipes already shipped in oke docker — SQL (including Cockroach, Yugabyte, Timescale), KV, proxy, and services.
Every recipe below is already wired into oke docker — pin an image in oke.config.ts
and get env, healthcheck, and a connection URL for free.
These recipes are real, working infrastructure choices behind the same two templates (standard, advanced) and the same eight elements — not alternative products or separate frameworks.
The one rule
Vendor choice lives in images[…] — never in drivers.*, which only ever say protocol ids
(postgres, redis, s3, smtp, meilisearch, openai-compatible, …).
SQL
Postgres
Default store.sql — POSTGRES_*, PGDATA, DATABASE_URL.
Supabase
supabase/postgres extension bundle only.
CockroachDB
Self-hosted single-node — port 26257, COCKROACH_*.
YugabyteDB
Self-hosted YSQL — port 5433, YSQL_*.
Timescale
Postgres + hypertables — same POSTGRES_* contract.
KV
Driver id stays redis for every image below.
Redis
Default store.kv — requirepass + maxmemory.
Valkey
BSD-licensed Redis-wire fork.
Dragonfly
Multi-threaded Redis-wire runtime.
Proxy
Opt-in via images.proxy — leave unset until you need an edge or --scale app=N.
Caddy
Automatic-HTTPS, single instance.
Traefik
Docker-label discovery + socket-proxy.
nginx
Static nginx.conf reverse proxy (HTTP).
Services
PgDog
Transaction pooler on :6432.
RustFS
S3-compatible store.files — /data volume.
Mailpit
SMTP catcher — UI on :8025.
Meilisearch
Full-text store.index on :7700.
AI
Compose does not manage inference. Prefer OpenRouter
for zero-Docker fx.ask, or BYO any OpenAI-shaped /v1 via OKE_AI_URL /
baseUrl — see Models.
| Workload | Where |
|---|---|
| Zero Docker / free cloud smoke | OpenRouter |
BYO OpenAI-compatible /v1 | Models |
| Managed cloud (registry) | Models |
OpenRouter
Zero Docker — openrouter/free + auto baseUrl.
Models
Registry providers + custom baseUrl / OKE_AI_URL.
Learn more
- Providers — managed cloud alternatives
- Configuration —
imagesroles and compose derivation - Store —
sql/kv/files/indexfacets