db-migrate
github.com
- Free plan
- Linux
- Self-hosted
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.
Plans
Every plan and pricedb-migrate
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.