{"id":49450,"library":"strapi-plugin-database-migration","title":"Strapi Database Migration Plugin","description":"A Strapi plugin for executing database migrations using node-migrate. Version 0.0.4 is the latest stable release. It wraps node-migrate commands (strapi-migrate-up, strapi-migrate-down, strapi-migrate-list) and optionally stores migration state in the database via a built-in store. Differentiates from raw node-migrate by integrating with Strapi's lifecycle. The plugin has not been updated since 2020 and has limited adoption.","status":"maintenance","version":"0.0.4","language":"javascript","source_language":"en","source_url":"https://github.com/ggirodda/strapi-plugin-database-migration","tags":["javascript"],"install":[{"cmd":"npm install strapi-plugin-database-migration","lang":"bash","label":"npm"},{"cmd":"yarn add strapi-plugin-database-migration","lang":"bash","label":"yarn"},{"cmd":"pnpm add strapi-plugin-database-migration","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core migration engine used under the hood","package":"node-migrate","optional":false},{"reason":"Plugin runs within Strapi ecosystem; requires Strapi to be installed","package":"strapi","optional":false}],"imports":[{"note":"Used as a CLI command via package.json scripts, not imported directly.","wrong":"npm run strapi-migrate-up","symbol":"strapi-migrate-up","correct":"npx strapi-migrate-up"},{"note":"The store is a CommonJS module; ESM import fails.","wrong":"import { strapiDatabaseStore } from 'strapi-plugin-database-migration'","symbol":"strapi-database-store","correct":"require('strapi-plugin-database-migration/lib/strapi-database-store')"}],"quickstart":{"code":"// Add to package.json scripts:\n\"strapi-migrate-up\": \"strapi-migrate-up --store strapi-plugin-database-migration/lib/strapi-database-store\",\n\"strapi-migrate-down\": \"strapi-migrate-down --store strapi-plugin-database-migration/lib/strapi-database-store\",\n\"strapi-migrate-list\": \"strapi-migrate-list --store strapi-plugin-database-migration/lib/strapi-database-store\"\n\n// Create a migration file: migrations/001-create-users.js\nmodule.exports = {\n  up: async (db) => {\n    await db.createCollection('users');\n  },\n  down: async (db) => {\n    await db.dropCollection('users');\n  }\n};\n\n// Run migration:\nnpm run strapi-migrate-up","lang":"javascript","description":"Shows how to set up scripts in package.json and create a sample migration file using the plugin."},"warnings":[{"fix":"Use Node 14 or consider an alternative like node-migrate directly.","message":"Node.js version constraint <=14.x.x; fails on Node 16+.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Run via npx: npx strapi-migrate-up --store ...","message":"The 'strapi-migrate-up' command is a global binary; ensure it's installed or use npx.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use CommonJS require; avoid ESM import.","message":"No TypeScript definitions; plugin uses require() style.","severity":"gotcha","affected_versions":">=0.0.0"}],"env_vars":null,"search_vec":"'0.0.4':17 '2020':74 'adopt':78 'built':52 'built-in':51 'command':28 'databas':2,10,48 'differenti':55 'execut':9 'integr':62 'javascript':79 'latest':20 'lifecycl':66 'limit':77 'list':40 'migrat':3,11,15,27,31,35,39,44,60 'node':14,26,59 'node-migr':13,25,58 'option':42 'plugin':4,7,68 'raw':57 'releas':22 'sinc':73 'stabl':21 'state':45 'store':43,54 'strapi':1,6,30,34,38,64 'strapi-migrate-down':33 'strapi-migrate-list':37 'strapi-migrate-up':29 'updat':72 'use':12 'version':16 'via':49 'wrap':24","created_at":"2026-06-07T17:01:50.506572+00:00","updated_at":"2026-06-07T17:01:50.506572+00:00","problems":[{"fix":"Add the script to package.json scripts as shown in quickstart and run via npm run.","cause":"Global binary not installed or not in PATH.","error":"Error: Cannot find module 'strapi-migrate-up'"},{"fix":"Use Node 14 or lower. If using Node 16+, migrate to a different solution.","cause":"Plugin explicitly restricts Node version in engines field.","error":"Error: The Node.js version (16.x.x) is not supported. Please use Node 10, 12, or 14."}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/ggirodda/strapi-plugin-database-migration","github":"https://github.com/ggirodda/strapi-plugin-database-migration","docs":null,"changelog":null,"pypi":null,"npm":"strapi-plugin-database-migration","openapi_spec":null,"status_page":null,"smithery":null,"categories":["database"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}