Blueprints

Twenty-seven apps. One command each.

A curated registry of templates for the software you actually run on a VPS. Each blueprint bundles the image, default ports, volumes, and env vars so cardinal blueprint install just works.

install a blueprint

cardinal blueprint list
cardinal blueprint info nginx
cardinal blueprint install minecraft-server
cardinal blueprint install nextcloud --name my-cloud -y

postgres-16 databases

PostgreSQL 16 with persistent storage.

postgres:16

mysql-8 databases

MySQL 8 with persistent storage.

mysql:8

mariadb-11 databases

MariaDB 11 with persistent storage.

mariadb:11

redis-7 databases

Redis 7 in-memory cache with persistence.

redis:7-alpine

mongodb-7 databases

MongoDB 7 with persistent storage.

mongo:7

clickhouse databases

Column-oriented analytics database.

clickhouse/clickhouse-server:latest

couchdb databases

CouchDB 3 with persistent JSON document storage.

couchdb:3

minecraft-server games

Minecraft Java Edition with persistent world.

itzg/minecraft-server:latest

valheim-server games

Valheim dedicated server with persistent world.

lloesche/valheim-server:latest

palworld-server games

Palworld dedicated server with persistent save.

thijsvanloef/palworld-server-docker:latest

rust-server games

Rust dedicated server via SteamCMD.

didstopia/rust-server:latest

cs2-server games

Counter-Strike 2 dedicated server via SteamCMD.

cm2network/csgo:latest

terraria-server games

Terraria dedicated server with persistent world.

beardedio/terraria:latest

satisfactory-server games

Satisfactory dedicated server with persistent save.

wolveix/satisfactory-server:latest

nginx web

Nginx web server with custom config and static files.

nginx:alpine

caddy web

Caddy web server with automatic HTTPS.

caddy:alpine

wordpress web

WordPress with persistent content and plugins.

wordpress:latest

ghost web

Ghost blogging platform with persistent content.

ghost:latest

node-app web

Node.js application with persistent code directory.

node:22-alpine

filebrowser web

Web-based file manager with authentication.

filebrowser/filebrowser:latest

grafana monitoring

Dashboards and observability platform.

grafana/grafana:latest

uptime-kuma monitoring

Self-hosted website monitoring.

louislam/uptime-kuma:latest

adguard-home network

Network-wide DNS filtering for ads and trackers.

adguard/adguardhome:latest

wireguard network

WireGuard VPN with web admin interface.

weejewel/wg-easy:latest

teamspeak-3 voice

TeamSpeak 3 voice server with persistent data.

teamspeak:latest

nextcloud storage

Self-hosted cloud storage and collaboration.

nextcloud:latest

jellyfin media

Free and open-source media streaming server.

jellyfin/jellyfin:latest

Multi-container stacks

Compose-ready examples.

Complete stacks that show how services connect over the cardinal0 bridge or through depends_on healthchecks — 13 examples, from a LEMP stack to a full field reference. Each lives in the examples/ directory of the blueprints repo.

cardinal.toml

wordpress-mysql

WordPress + MySQL 8 — Blog with persistent DB and content.

wordpress-mysql.toml

cardinal up -f examples/wordpress-mysql.toml

cardinal.toml

nextcloud-postgres

Nextcloud + PostgreSQL 16 — Cloud storage with a DB backend.

nextcloud-postgres.toml

cardinal up -f examples/nextcloud-postgres.toml

cardinal.toml

node-postgres-app

Node.js + PostgreSQL 16 — Web app plus database with healthcheck.

node-postgres-app.toml

cardinal up -f examples/node-postgres-app.toml

cardinal.toml

python-bot-postgres

Python bot + PostgreSQL + Redis — Telegram/Discord bot with DB and cache.

python-bot-postgres.toml

cardinal up -f examples/python-bot-postgres.toml

cardinal.toml

nginx-node-reverse-proxy

Node.js + Nginx — App behind a reverse proxy.

nginx-node-reverse-proxy.toml

cardinal up -f examples/nginx-node-reverse-proxy.toml

cardinal.toml

grafana-prometheus

Grafana + Prometheus — Monitoring and observability.

grafana-prometheus.toml

cardinal up -f examples/grafana-prometheus.toml

cardinal.toml

lemp-stack

Nginx + PHP 8.2 + MariaDB — Classic LEMP web stack.

lemp-stack.toml

cardinal up -f examples/lemp-stack.toml

cardinal.toml

redis-queue-worker

Redis + API + Worker — Queue-based async processing.

redis-queue-worker.toml

cardinal up -f examples/redis-queue-worker.toml

cardinal.toml

traefik-whoami

Traefik + 2× whoami — Reverse proxy with label-based routing.

traefik-whoami.toml

cardinal up -f examples/traefik-whoami.toml

cardinal.toml

minecraft-backup

Minecraft + Backup — Game server with periodic backups.

minecraft-backup.toml

cardinal up -f examples/minecraft-backup.toml

compose yaml

wordpress-mysql-compose

WordPress + MySQL 8 — Compose-compatible YAML variant of the WordPress stack.

wordpress-mysql-compose.yml

cardinal up -f examples/wordpress-mysql-compose.yml

compose yaml

node-postgres-compose

Node.js + PostgreSQL 16 — Compose-compatible YAML variant of the Node + Postgres stack.

node-postgres-compose.yml

cardinal up -f examples/node-postgres-compose.yml

cardinal.toml

full-reference

Every cardinal.toml field — All options documented — healthchecks, depends_on, secrets, ulimits, sysctls, labels, and more.

full-reference.toml

cardinal up -f examples/full-reference.toml

Browse all examples on GitHub →

Need several at once?

The Stack Builder lets you pick multiple services and generates a ready cardinal.toml — deploy a whole stack with cardinal up -f cardinal.toml.

Ship your own blueprint.

Templates are plain JSON in a public registry. Add a file, register it, and open a pull request against the blueprints repo.

Contribute on GitHub