{"record":{"id":"d50d94ca6bcc4803","repo":"remotion-dev/remotion","slug":"failed-to-upgrade-remotion-see-logs-above","errorCode":null,"errorMessage":"Failed to upgrade Remotion, see logs above","messagePattern":"Failed to upgrade Remotion, see logs above","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/cli/src/upgrade.ts","lineNumber":293,"sourceCode":"\tlogLevel: LogLevel;\n}) => {\n\tconst task = spawn(manager, command, {\n\t\tenv: {\n\t\t\t...process.env,\n\t\t\tADBLOCK: '1',\n\t\t\tDISABLE_OPENCOLLECTIVE: '1',\n\t\t},\n\t\tstdio: RenderInternals.isEqualOrBelowLogLevel(logLevel, 'info')\n\t\t\t? 'inherit'\n\t\t\t: 'ignore',\n\t});\n\n\tawait new Promise<void>((resolve) => {\n\t\ttask.on('close', (code) => {\n\t\t\tif (code === 0) {\n\t\t\t\tresolve();\n\t\t\t} else if (RenderInternals.isEqualOrBelowLogLevel(logLevel, 'info')) {\n\t\t\t\tthrow new Error('Failed to upgrade Remotion, see logs above');\n\t\t\t} else {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t'Failed to upgrade Remotion, run with --log=info info to see logs',\n\t\t\t\t);\n\t\t\t}\n\t\t});\n\t});\n};\n","sourceCodeStart":275,"sourceCodeEnd":302,"githubUrl":"https://github.com/remotion-dev/remotion/blob/78fe4bb3fdb5a2cd68724393d63cb223db333fa7/packages/cli/src/upgrade.ts#L275-L302","documentation":"Thrown by the upgrade command after the spawned package-manager process (npm/yarn/bun/pnpm install) exits with a non-zero code while stdio was set to 'inherit' (log level at or below 'info'). The installer's own output was streamed to the terminal, so the message points you to those logs.","triggerScenarios":"The package manager failed during `remotion upgrade`: a version conflict, a peer-dep error, a network failure, a registry outage, or an incompatible Node/Bun version. Because logs were visible, the root cause is in the terminal scrollback.","commonSituations":"Conflicting Remotion versions across a monorepo; a peer dependency conflict with another package; transient npm registry errors; corporate proxy blocking the registry; a corrupted package-lock that fails to update.","solutions":["Scroll up in the terminal and read the package-manager error output immediately preceding this message.","Address the underlying error: resolve version conflicts, fix peer deps, retry on a network blip.","For monorepo conflicts, upgrade all @remotion/* packages together (`npx remotion upgrade` does this; mixing manual installs can desync).","Clear the lockfile and node_modules if corrupted: `rm -rf node_modules package-lock.json && npm install`."],"exampleFix":"// before\n$ npx remotion upgrade\n... npm ERR! ERESOLVE could not resolve ...\nFailed to upgrade Remotion, see logs above\n// after - resolve conflict then retry\n$ npm install --legacy-peer-deps   # or fix the conflicting version\n$ npx remotion upgrade","handlingStrategy":"try-catch","validationCode":"const {spawnSync} = require('child_process');\n\nconst preflightUpgrade = (manager: string) => {\n  const dry = spawnSync(manager, ['install', '--dry-run'], {stdio: 'pipe'});\n  if (dry.status !== 0) {\n    throw new Error(`Pre-upgrade install check failed:\\n${dry.stderr.toString()}`);\n  }\n};\n\npreflightUpgrade(packageManager);","typeGuard":null,"tryCatchPattern":"try {\n  await upgradeCli({logLevel: 'info'});\n} catch (err) {\n  if (err instanceof Error && err.message === 'Failed to upgrade Remotion, see logs above') {\n    // inspect installer output already streamed; resolve conflicts then retry\n  }\n  throw err;\n}","preventionTips":["Keep all @remotion/* versions in sync to avoid peer-dep conflicts.","Run upgrades with --log=info so installer output is visible.","In monorepos, use the workspace install command rather than manual per-package upgrades."],"tags":["cli","upgrade","package-manager","network"],"backgroundTag":null,"analyzedSha":"78fe4bb3fdb5a2cd68724393d63cb223db333fa7","analyzedAt":"2026-08-12T17:18:50.444Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}