// troubleshooting guide · metabase
Metabase 'Database Has Migration Lock' After Upgrade
- Status
- Workaround available
- platforms:
- Self-hosted
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · metabase/migration-lock4 FIXES
// quick answer
A previous upgrade or crash left a lock in the application database, so Metabase refuses to start. Make sure no other instance is running, back up the database, then release the lock with java -jar metabase.jar migrate release-locks.
Most likely fix: Stop every other instance
How to fix it
// try these in order, the most common fix is first
FIX 1Stop every other instance
- 01Scale to a single Metabase instance
- 02Confirm no other container is connected to the application database
Did this fix it?FIX 2Back up, then release the lock
- 01Back up the application database
- 02Run java -jar metabase.jar migrate release-locks with the same MB_DB_* settings
- 03Start Metabase normally
Did this fix it?FIX 3Give migrations time
- 01Raise your orchestrator's health-check or startup timeout
- 02Watch docker logs until migrations finish
Did this fix it?FIX 4Read the first error, not the last
- 01Search the logs for the first ERROR line
- 02If a migration partly applied, restore the backup and upgrade again, or post the error on the Metabase forum
Did this fix it?
SANDBOX · metabase RUNS IN YOUR BROWSER
Try it: browse a sample shop and watch visitors, funnels and live data arrive
A hands-on Metabase-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Metabase won't start after an upgrade; logs repeat 'Database has migration lock; cannot run migrations' or 'Could not acquire change log lock'.
Why it happens
- C-01Upgrade interrupted or container killed mid-migration
- C-02Two Metabase instances migrating the same database
- C-03Health-check timeout killing the container during a long migration
- C-04A migration that partly applied (for example a table that already exists)
// this guide also covers
- metabase migration lock
- metabase could not acquire change log lock
- metabase upgrade failed
- metabase won't start after upgrade
Still not working?
If Metabase keeps failing, you're not alone. See every Metabase problem users report or the alternatives people switch to.
Done fighting Metabase? Our small team builds your own Metabase alternative, or any software you need: web, mobile, games, desktop. Price agreed together.
Talk to usOther Metabase errors
- Metabase Dashboard Slow or Not Loading
- Metabase 'Your Question Took Too Long' Error
- Metabase Not Syncing New Tables or Columns
- Metabase Filter Dropdown Not Showing Values
- Metabase Linked Filters Not Working
- Metabase Not Sending Emails or Alerts
- Metabase Can't Connect to Database
- Metabase Tables Not Showing