Create, connect, snapshot, and clone Postgres boxes fast.

​
Quick Start

zomg pg create my-db
zomg pg connect my-db
You’ll see “ready to connect” after creation. The connect command opens a psql session. Inside a box, psql -h <box>.<project> works directly.

​
Create

zomg pg create my-db
  • Creates a Postgres box quickly
  • Waits for port readiness, then prints a connect hint
  • Fails if the name already exists

​
Connect

zomg pg connect my-db
  • Uses psql if available
  • When inside a box, direct DNS resolution works
  • From a local machine, DNS/ports may not resolve; zomg pg falls back to an in-box psql session when needed
Pass additional psql args after --: 
zomg pg connect my-db -- -c "select 1"

​
Snapshot (Hard)

zomg pg snapshot my-db
zomg pg snapshot my-db my-snapshot
  • Hard snapshots by default (no stop)
  • Designed for instant boxes and WAL crash recovery

​
Clone

zomg pg create my-test-db --fork my-db
zomg pg connect my-test-db
  • Creates a box from a hard snapshot of my-db
  • Keeps the source running
  • New instance is ready to connect quickly

​
Stop (Clean)

zomg pg stop my-db
  • Performs a clean stop (CHECKPOINT + smart shutdown)

​
Defaults

  • User: postgres
  • Database: postgres
  • Password: postgres