{"record":{"id":"08334b7bcbbb156f","repo":"RocketChat/Rocket.Chat","slug":"upgrade-not-supported-it-seems-you-re-trying-to","errorCode":null,"errorMessage":"UPGRADE NOT SUPPORTED!\n\nIt seems you're trying to upgrade from an unsupported version!\n\nTo be able to update to version 7.x.y you need to update to version 6.x first.\n\nRead more: https://go.rocket.chat/i/how-to-upgrade","messagePattern":"UPGRADE NOT SUPPORTED!\n\nIt seems you're trying to upgrade from an unsupported version!\n\nTo be able to update to version 7\\.x\\.y you need to update to version 6\\.x first\\.\n\nRead more: https://go\\.rocket\\.chat/i/how-to-upgrade","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"critical","filePath":"apps/meteor/server/startup/migrations/minimumVersion.ts","lineNumber":8,"sourceCode":"import { addMigration } from '../../lib/migrations';\n\n// this was the first migration added on version 6.0, so if this needs to run,\n// it means the server was never updated to 6.x, which is not supported.\naddMigration({\n\tversion: 292,\n\tup() {\n\t\tthrow new Error(\n\t\t\t[\n\t\t\t\t'UPGRADE NOT SUPPORTED!',\n\t\t\t\t'',\n\t\t\t\t`It seems you're trying to upgrade from an unsupported version!`,\n\t\t\t\t'',\n\t\t\t\t'To be able to update to version 7.x.y you need to update to version 6.x first.',\n\t\t\t\t'',\n\t\t\t\t'Read more: https://go.rocket.chat/i/how-to-upgrade',\n\t\t\t].join('\\n'),\n\t\t);\n\t},\n});\n","sourceCodeStart":1,"sourceCodeEnd":21,"githubUrl":"https://github.com/RocketChat/Rocket.Chat/blob/b2c16d5842cbe6b69b59bdf6fc5e5f1afcd1f0b0/apps/meteor/server/startup/migrations/minimumVersion.ts#L1-L21","documentation":"Migration 292 is a sentinel: it was the first migration added in Rocket.Chat 6.0, so if the migrations framework reaches it during upgrade, the database's control version predates 6.x. Instead of attempting an unsupported multi-hop upgrade to 7.x, the migration deliberately throws a plain Error with upgrade instructions (update to 6.x first). This halts the migration run and therefore server startup.","triggerScenarios":"Starting a 7.x build against a database whose _migrations control version is below 292 (server last ran a pre-6.0 release, e.g. 5.x), so the migration chain tries to execute version 292's up().","commonSituations":"Skipping major versions during upgrade (5.x -> 7.x); restoring an old backup onto a new binary; Docker image tag jumps multiple majors; snap/channel upgrades.","solutions":["Deploy an intermediate 6.x release first, let migrations complete, then upgrade to 7.x (follow https://go.rocket.chat/i/how-to-upgrade).","If the data is disposable, start with a fresh database instead of migrating.","Verify the current control version in the _migrations collection to confirm how far behind the database is."],"exampleFix":"# before: 5.x database started on 7.x image -> migration 292 throws\n# after: stepwise upgrade\ndocker run rocket.chat:6.x  # let migrations finish, check logs\n# then\ndocker run rocket.chat:7.x  # now migration 292 is already passed\n# inspect control version:\nmongosh rock_chat --eval 'db.getCollection(\"_migrations\").findOne()'","handlingStrategy":"validation","validationCode":"// Before upgrading, inspect the migration control version\nmongosh rock_chat --eval 'db.getCollection(\"_migrations\").findOne()'\n// if version < 292: first deploy a 6.x release, then 7.x","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Never skip major versions; upgrade sequentially (5.x -> 6.x -> 7.x).","Back up the database before every major upgrade.","Automate version checks in deployment scripts using the _migrations collection."],"tags":["rocket-chat","migration","upgrade","version-compatibility"],"backgroundTag":"unsupported-database-migration-version","analyzedSha":"b2c16d5842cbe6b69b59bdf6fc5e5f1afcd1f0b0","analyzedAt":"2026-08-18T15:26:39.429Z","contentChangedAt":"2026-08-18T15:26:39.429Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}