Registry / database / migrate-mongo-multi

migrate-mongo-multi

JSON →
library1.0.2jsnpmunverified

Wrapper around migrate-mongo that allows running database migrations against multiple MongoDB databases or clusters simultaneously. Version 1.0.2 requires Node >=8 and peer dependency on mongodb driver ^4.4.1 || ^5.0.0 || ^6.0.0. It simplifies scenarios with sharded clusters, multi-tenant setups, or separate environments needing synchronized schema changes. Supports all migrate-mongo CLI commands (up, down, status, create) with a --config flag pointing to a JSON array of per-database configurations. Release cadence is low; only a few versions published.

database
npm install migrate-mongo-multi
package ↗
INSTALL
IMPORT
SIG · MIGRATE-MONGO-MULT
M
migrate-mongo-multi
databasejavascriptv1.0.2
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

migrate-mongo-multi
✓ import migrate from 'migrate-mongo-multi'
✗ const { migrate } = require('migrate-mongo-multi')
Default export is a function; named export not available. Use require('migrate-mongo-multi') for CommonJS.

Shows how to define multiple database configurations and run 'up' migrations on all of them.

import migrate from 'migrate-mongo-multi'; import { MongoClient } from 'mongodb'; const config = [ { url: process.env.MONGO_URL1 ?? 'mongodb://localhost:27017', database: 'db1', migrationsDir: './migrations', changelogCollectionName: 'changelog' }, { url: process.env.MONGO_URL2 ?? 'mongodb://localhost:27018', database: 'db2', migrationsDir: './migrations', changelogCollectionName: 'changelog' } ]; async function run() { await migrate(config, 'up'); console.log('Migrations complete for all databases'); } run().catch(console.error);
Debug
Known issues
gotchaEach database config must have a unique 'changelogCollectionName' or they will conflict if using same MongoDB instance with multiple databases.
fix
Ensure collection names are unique or use different databases to avoid changelog collisions.
affects: >=1.0.0
deprecatedThe package does not support Node.js versions below 8; some users on older Node may experience issues.
fix
Upgrade Node.js to version 8 or higher.
affects: >=1.0.0
Errors
Common errors & fixes
Cannot find module 'migrate-mongo'
migrate-mongo-multi depends on migrate-mongo as a peer dependency, but it is not installed.
fix
Install migrate-mongo: npm install migrate-mongo
TypeError: config is not iterable
The config passed to migrate() is not an array.
fix
Wrap config in an array: migrate([config], 'up');
Upgrade
Version history
1.0.2latest on npm
Audit
Dependencies
migrate-mongorequiredcore dependency for migration logic
mongodbrequiredpeer dependency for MongoDB driver
Agent activity
6 hits · last 30 days
node
6
Resources
packagemigrate-mongo-multi ↗
migrate-mongo-multi — npm install migrate-mongo-multi · libregistry