Skip to content
pgferry

Install

pgferry is a single Go binary. There are no sidecar services, no runtime agents, and no extra database middleware to deploy.

Download a release

Section titled “Download a release”

Grab the latest binary from GitHub Releases.

After downloading, verify the binary is reachable:

Terminal window
pgferry version

Build from source

Section titled “Build from source”
Terminal window
git clone https://github.com/Limetric/pgferry.git
cd pgferry
go build -o build/pgferry .
./build/pgferry version

What the binary expects

Section titled “What the binary expects”
  • A source DSN for MySQL, SQLite, or MSSQL.
  • A target PostgreSQL DSN.
  • A TOML config file describing schema, type mapping, and migration behavior.

Test locally

Section titled “Test locally”

Unit tests do not require a database:

Terminal window
go test ./... -count=1

Integration coverage is split by source type. The repository README includes the exact environment variables and commands for MySQL, SQLite, and MSSQL runs.

Next step

Section titled “Next step”

Move to Quick Start to create a minimal config and run your first migration.