Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Umzug

github.com

  • Free plan
  • Self-hosted
6.6 Club score Visit github.com

What Umzug is

Umzug is a free, MIT-licensed migration library for Node.js that runs and rolls back migration tasks. It is framework-agnostic rather than tied to Sequelize, while still supporting Sequelize and MongoDB storage. The API can list pending or executed migrations, apply pending work, and revert migrations. Its built-in CLI can apply, revert, list, and create migration files. Files may use JavaScript or TypeScript, and custom resolvers can accommodate formats such as SQL. Migration history can be stored in JSON, memory, Sequelize, MongoDB, or a custom implementation. Written in TypeScript, Umzug includes built-in typings and IDE autocomplete. Type-safe events run before and after migration and command operations, while FileLocker provides filesystem-based locking through beforeAll and afterAll events. Failed migrations become MigrationError objects containing metadata and the original error. File-based migrations sort lexicographically by path by default, so names should follow the intended sequence. The README says testing covers Sequelize v6, with lower-version compatibility uncertain.

Who it suits

Umzug suits Node.js developers who need migration execution, rollback, flexible storage, and CLI control. It is useful when a project should not depend exclusively on Sequelize.

Good to know, and what to watch

  • Framework-agnostic Node.js migrations
  • Supports applying and rolling back
  • Multiple history storage backends
  • JavaScript, TypeScript, or custom formats
  • Type-safe events and error metadata
  • Lower Sequelize versions may not work
  • Version 3 CLI is described as new
  • File ordering depends on names

Umzug

Free

Free plan

The verdict

Umzug provides migration APIs, a command-line interface, rollback support, and configurable storage without requiring Sequelize. Teams should account for its documented version and CLI maturity notes.

What the maker publishes

CLI
The built-in CLI can apply, revert, list, and create migrations. source
CLI maturity
The README describes the v3 CLI as new and invites feedback through GitHub Discussions. source
Database integration
Umzug is not coupled to Sequelize, though it supports Sequelize storage and MongoDB storage. source
Error handling
Migration failures are rethrown as MigrationError objects containing migration metadata and the original error. source
Events
Type-safe events are available before and after migration and command operations. source
Execution
Its API can list pending or executed migrations and apply or revert migrations. source
File locking
The FileLocker class provides a simple filesystem-based locking mechanism using beforeAll and afterAll events. source
Language support
It is written in TypeScript and includes built-in typings and IDE autocomplete. source
License
The public repository identifies the project license as MIT. source
Migration formats
Migration files can use JavaScript or TypeScript, and custom resolvers can support other formats such as SQL. source
Ordering
File-based migrations are sorted lexicographically by path by default, and the documentation recommends names that sort in the intended run order. source
Purpose
Umzug is a framework-agnostic migration tool for Node.js that runs and rolls back tasks. source
Storage options
Migration history can be stored in JSON, memory, Sequelize, MongoDB, or a custom storage implementation. source
Version compatibility
The README says the library has been tested with Sequelize v6 and may or may not work with lower versions. source

Checked against the maker's pages on 9 Oct 2026.