{"record":{"id":"723c4763b3b180a0","repo":"remotion-dev/remotion","slug":"please-upgrade-to-at-least-bun-1-0-3","errorCode":null,"errorMessage":"Please upgrade to at least Bun 1.0.3","messagePattern":"Please upgrade to at least Bun 1\\.0\\.3","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/cli/src/index.ts","lineNumber":74,"sourceCode":"\tconst [command, ...args] = parsedCli._;\n\n\tconst packageManager = packageManagerOption.getValue({\n\t\tcommandLine: parsedCli,\n\t}).value;\n\n\tconst remotionRoot = RenderInternals.findRemotionRoot();\n\tif (command !== VERSIONS_COMMAND && !parsedCli.help) {\n\t\tawait validateVersionsBeforeCommand(remotionRoot, 'info');\n\t}\n\n\tconst logLevel = await initializeCli(remotionRoot);\n\n\tconst isBun = typeof Bun !== 'undefined';\n\tif (isBun) {\n\t\tconst version = Bun.version.split('.');\n\t\tif (version.length === 3) {\n\t\t\tif (Number(version[0]) < 1) {\n\t\t\t\tthrow new Error('Please upgrade to at least Bun 1.0.3');\n\t\t\t}\n\n\t\t\tif (Number(version[1]) === 0 && Number(version[2]) < 3) {\n\t\t\t\tthrow new Error('Please upgrade to at least Bun 1.0.3');\n\t\t\t}\n\t\t}\n\n\t\tLog.info(\n\t\t\t{indent: false, logLevel},\n\t\t\t'You are running Remotion with Bun, which is mostly supported. Visit https://remotion.dev/bun for more information.',\n\t\t);\n\t}\n\n\tconst isStudio = command === 'studio' || command === 'preview';\n\n\tconst errorSymbolicationLock = isStudio\n\t\t? 0\n\t\t: RenderInternals.registerErrorSymbolicationLock();","sourceCodeStart":56,"sourceCodeEnd":92,"githubUrl":"https://github.com/remotion-dev/remotion/blob/78fe4bb3fdb5a2cd68724393d63cb223db333fa7/packages/cli/src/index.ts#L56-L92","documentation":"Thrown by the CLI bootstrap when it detects it is running under Bun (typeof Bun !== 'undefined') and the parsed major version is less than 1 (i.e. any 0.x build). Remotion needs Bun >= 1.0.3 for compatibility; older Bun releases break bundling and module resolution.","triggerScenarios":"Running `bunx remotion ...` or invoking the CLI with the `bun` runtime when `bun --version` reports a 0.x release (e.g. 0.7.0, 0.8.x).","commonSituations":"System still has the old Bun pre-1.0 install; a CI image pinned to an outdated Bun; using `bun` instead of `npx` for the first time on a stale machine.","solutions":["Upgrade Bun: `curl -fsSL https://bun.sh/install | bash` (or `brew upgrade bun`).","Confirm `bun --version` reports >= 1.0.3.","If you cannot upgrade Bun, run the CLI under Node: `npx remotion ...`."],"exampleFix":"// before\n$ bun --version\n0.8.1\n$ bunx remotion render ...\n// after\n$ bun upgrade\n$ bun --version\n1.1.0\n$ bunx remotion render ...","handlingStrategy":"validation","validationCode":"const assertBunVersion = () => {\n  if (typeof Bun === 'undefined') return;\n  const [maj, min, patch] = Bun.version.split('.').map(Number);\n  if (maj < 1 || (maj === 1 && min === 0 && patch < 3)) {\n    throw new Error(`Bun ${Bun.version} is too old. Upgrade to >= 1.0.3`);\n  }\n};\n\nassertBunVersion();","typeGuard":"const isBunSupported = (version: string): boolean => {\n  const [maj, min, patch] = version.split('.').map(Number);\n  return maj > 1 || (maj === 1 && (min > 0 || patch >= 3));\n};","tryCatchPattern":null,"preventionTips":["Pin Bun to a recent 1.x in CI images (e.g. `oven/bun:1.1`).","Run `bun upgrade` as part of environment setup.","When in doubt, fall back to Node (`npx remotion ...`)."],"tags":["cli","bun","version","runtime"],"backgroundTag":null,"analyzedSha":"78fe4bb3fdb5a2cd68724393d63cb223db333fa7","analyzedAt":"2026-08-12T17:18:50.444Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}