Guide

Meridian deploys containers to Linux servers you already have: SSH in, write Podman Quadlets, let systemd supervise them, and switch traffic with kamal-proxy. This guide takes you from install to a running production deployment.

meridian init reads your project and writes a config that fits it — Marten, Rails, Elixir, Go, and Node are each recognized by their standard layout and get the production defaults that framework expects.

Pages

• Quickstart — install, initialize, provision a host, deploy.
• Concepts — deploy flow, Quadlets, runtime state, same-host topology, blue/green. Read this before debugging anything.
• Multi-App Hosting — add a second app to a VPS that already runs one Meridian service.
• Pre-Flight Checklist — DNS, images, app ports, secrets, and accessories, verified before the first deploy.
• Troubleshooting — the failures you actually hit, with copy-paste diagnostics.

Beyond the guide: Recipes are complete deploy.yml and Containerfile starters per stack, and the Reference documents every config key and command.