OSS TanbouSign in with GitHub

run SQL and Go-function schema migrations from a CLI or library

About these scores

OSS scale score is an unbounded metric that log-compresses and weights Stars, Watchers, Forks, and Contributors. Discovery score is the current OSS scale score minus the score at discovery. Update pace is commits in the last 30 days, growth momentum is the OSS scale score difference within the recent observation window, and OSS health is a 0–100 rating based on available recency, Community Health, and release data.

Stars
11,544
Primary language
Go
License
MIT
Repository last updated
Oct 3, 2026
On this page

Overview

goose is a CLI and Go library for incremental database-schema changes. It supports SQL migrations, Go-function migrations, embedded migrations, out-of-order application, seeding, environment-variable substitution, and drivers for PostgreSQL, MySQL, SQLite, Spanner, ClickHouse, MSSQL, and more.

Features and best fit

Based on official documentation; not hands-on tested · Content checked:

Key features

Manage SQL and Go-function migrations through one version workflow

Timestamped or sequential migrations can be created and moved through up, down, up-to, down-to, redo, status, and related commands.

Sources: [2]

Add embedded migrations, out-of-order application, seeding, and locking when needed

Go embed-based migrations, applying missing migrations, seed data, SQL environment-variable substitution, and database-specific locking options are available for application workflows.

Sources: [2][4]

Best fit

Fits Go projects that want schema migrations maintained alongside application code

It works as both a standalone CLI and an embeddable library, making it suitable for repositories that want SQL and Go-code migrations in the same deployment workflow.

Sources: [2]

Before adoption

v3.28.0 raises the minimum to Go 1.26 and changes some driver-specific version-table behavior

The v3.28.0 go.mod declares Go 1.26. The release adds Azure SQL and a MySQL/MariaDB table locker, and changes new ClickHouse version-table ordering plus MySQL/TiDB timestamp column types. Verify version-table schema, locking, and driver-specific behavior when upgrading.

Sources: [3][4][2]

Official sources

  1. [1]pressly/goose — GitHub repository(2026-10-06)
  2. [2]goose v3.28.0 — README(2026-10-06)
  3. [3]goose v3.28.0 — go.mod(2026-10-06)
  4. [4]goose v3.28.0 release(2026-10-06)
  5. [5]goose MIT license(2026-10-06)
Supplemental curator note

goose supports both SQL and Go-function migrations, including embedding and seeding. Production deployments should pin migration ordering and immutability, locking strategy, transaction expectations, and driver build tags.

Try it in 3 steps

  1. 1

    Get the source

    git clone --depth 1 https://github.com/pressly/goose.git
  2. 2

    Enter the repository

    cd goose
  3. 3

    Check the official steps

    Continue with the commands in the README Installation, Quick Start, or Getting Started section.

    find . -maxdepth 1 -iname 'README*' -exec sed -n '1,220p' {} \; -quit
Check the official README

Growth

Growth trends · Last 30 days

11,544 Stars

Trend data is still being collected.

Development activity

Last 90 days · weekly

Commits (last 30 days)
3
Open PRs
44

Development activity is still being collected.

Built with

Categories and tags

GitHub data

GitHub dataView detailed GitHub data

GitHub Topics

  • database
  • sql
  • migration
  • schema
  • postgres
  • mysql
  • sqlite
  • golang
  • go
  • migrations
  • database-migrations
  • postgresql
Stars
11,544
Forks
711
Watchers
65
Open issues
94
Contributors
136
Owner type
Organization
Primary language
Go
License
MIT
Repository last updated
Oct 3, 2026
Write a related article

Share a guide or use case for this OSS in Markdown. Articles are published after administrator approval.

Report incorrect information

Tell us if any listing information is incorrect or outdated.

After reading this page, do you know what to do next?