Skip to content


Repository files navigation

roamer CI status Go Reference

roamer is a tool that makes handling database migrations easy. It's inspired by alembic and golang-migrate.

It's available as a command-line tool that can be used with any programming language or framework; however, if you're using Go, you can also embed roamer directly into your program.


While the command-line interface is mostly stable, the Go API should not be considered stable quite yet! It's possible that a future release of roamer might change the Go API; however, if that does happen, the breaking change would be released in a new minor version, following the Go module versioning policy.


First, follow the installation instructions.

Then, you're encouraged to follow along with the guided example.

Other articles

Also, if you want to provide instructions for other users on how to set up roamer with your project, you can link to the Connecting an existing project to your database wiki page.