Skip to main content

Troubleshooting

Common Issues​

pgschema is not installed​

Solution: pgschema should be bundled in vendor/pgschema/. Verify the binary for your platform exists, or install manually and set db.pgSchemaBin in config.

dbmate is not installed​

Solution: dbmate should be installed via npm. Run npm install in the CLI directory, or install manually (brew install dbmate) and set db.dbmateBin in config.

Failed to connect to remote database​

Solution: Check the remote URL in postkit db remote list

No remotes configured​

Solution: Add a remote with postkit db remote add <name> <url>

No active migration session​

Solution: Run postkit db start first

Plan file is empty​

Solution: Schema files match current DB — make changes first

Schema files have changed since the plan was generated​

Solution: Schema files were modified after running plan. Run postkit db plan again

Grants/seeds failed during apply​

Solution: Re-run postkit db apply — it resumes from where it left off

Deploy failed during dry run​

Solution: No changes were made to the target. Fix the issue and retry.

Getting Help​

If you're still stuck, please open an issue on GitHub.