db start
Clone a remote database to local and initialize a migration session.
Usage
postkit db start [--remote <name>]
Options
| Option | Description |
|---|---|
--remote <name> | Use specific remote (otherwise uses default) |
-v, --verbose | Enable verbose output |
--dry-run | Show what would be done without making changes |
--json | Output as JSON |
Examples
# Uses default remote
postkit db start
# Use specific remote
postkit db start --remote staging
What It Does
- Checks prerequisites (pgschema, dbmate installed)
- Resolves target remote (default or specified)
- Tests connection to remote database
- Clones remote database to local using
pg_dumpandpsql - Creates a session file (
.postkit/db/session.json) to track state