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

db-migrate

github.com

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

What db-migrate is

db-migrate is a database migration framework for Node.js applications, available as free, MIT-licensed software for self-hosting. Its command-line interface can apply or roll back migrations, reset migration state, create migration files, and work with the database. Supported databases include MySQL, PostgreSQL, sqlite3, MongoDB, and CockroachDB; database drivers are installed separately. Migration files can use callback-based or promise-based interfaces, and the --sql-file option creates separate files for up and down statements. The framework records applied migrations in a migrations table. Environment settings can be loaded from database.json, and command-line options let users select an environment and configuration file. Configuration values such as usernames and passwords can refer to environment variables. The project documents global and local npm installation. Its package metadata specifies Node.js 8.0.0 or later, while the project officially supports Node.js 24 and newer; older versions may work but are not tested. Documentation and examples are available through Read the Docs.

Who it suits

It suits Node.js teams that need to manage database changes across supported database systems. Self-hosting and separately installed database drivers are part of its setup.

Good to know, and what to watch

  • Supports five listed database systems.
  • Offers up, down, reset, create, and db commands.
  • Tracks applied migrations in a database table.
  • Supports environment-variable references in configuration.
  • Database drivers must be installed separately.
  • Node.js versions older than 24 are not officially supported.
  • MIT license provides the software without warranty.

db-migrate

Free

Open source

The verdict

db-migrate provides migration commands, tracking, and configuration options for Node.js applications. Check the officially supported Node.js version and install the required database drivers before using it.

What the maker publishes

Additional database
The documentation also lists CockroachDB as an officially supported database. source
Compatibility
The README says db-migrate 0.11 and older are end of life, while v1 migrations continue to work unchanged. source
Credentials
The configuration documentation supports environment-variable references for values such as database usernames and passwords. source
Databases
The project lists MySQL, PostgreSQL, sqlite3, and MongoDB as officially supported databases. source
Documentation
The repository links to the project's full documentation and usage examples on Read the Docs. source
Environments
Environment settings can be loaded from database.json, with CLI options to choose an environment and config file. source
Install
The project documents global installation with npm install -g db-migrate and local installation with npm install db-migrate. source
Installation
The project documents global installation with npm install -g db-migrate and local installation with npm install db-migrate. source
License
The project is distributed under the MIT License, which includes an 'AS IS' warranty disclaimer. source
License
The project is distributed under the MIT License. source
Migration commands
The command-line interface supports up, down, reset, create, and db commands. source
Migration styles
Migration files can use callback-based or promise-based interfaces. source
Migration tracking
The documentation says db-migrate creates a migrations table to track which migrations have been applied. source
Node support
The project says Node.js 24 and newer are officially supported and older versions may work but are not tested. source
Purpose
db-migrate is a database migration framework for Node.js. source
Purpose
db-migrate describes itself as a database migration framework for Node.js. source
Runtime
The package metadata specifies Node.js version >=8.0.0. source
Security
The repository page displays a Security and quality section with 0 findings. source
Security terms
The MIT license states that the software is provided as is without warranty. source
SQL files
The --sql-file option generates separate SQL files for migration up and down statements. source
SSH
The README says SSH tunneling is provided by a plugin that can be installed next to db-migrate. source
Support
The README directs users to the project documentation for usage instructions and examples and points to Open Collective for backers and sponsorship. source
Support
The repository invites users to seek project support through backer and sponsor contributions. source
Supported databases
The documentation lists MySQL, PostgreSQL, sqlite3, MongoDB, and CockroachDB as supported databases. source

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