{"record":{"id":"a80d7c6eaa0274c3","repo":"remotion-dev/remotion","slug":"unsupported-architecture-on-macos-process-arch","errorCode":null,"errorMessage":"Unsupported architecture on macOS: ${process.arch}","messagePattern":"Unsupported architecture on macOS: (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/compositor/build.ts","lineNumber":62,"sourceCode":"\tswitch (process.platform) {\n\t\tcase 'win32':\n\t\t\tswitch (process.arch) {\n\t\t\t\tcase 'x64':\n\t\t\t\t\treturn 'x86_64-pc-windows-gnu';\n\t\t\t\tdefault:\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Unsupported architecture on Windows: ${process.arch}`,\n\t\t\t\t\t);\n\t\t\t}\n\n\t\tcase 'darwin':\n\t\t\tswitch (process.arch) {\n\t\t\t\tcase 'x64':\n\t\t\t\t\treturn 'x86_64-apple-darwin';\n\t\t\t\tcase 'arm64':\n\t\t\t\t\treturn 'aarch64-apple-darwin';\n\t\t\t\tdefault:\n\t\t\t\t\tthrow new Error(`Unsupported architecture on macOS: ${process.arch}`);\n\t\t\t}\n\n\t\tcase 'linux':\n\t\t\tswitch (process.arch) {\n\t\t\t\tcase 'x64':\n\t\t\t\t\tif (isMusl()) {\n\t\t\t\t\t\treturn 'x86_64-unknown-linux-musl';\n\t\t\t\t\t}\n\n\t\t\t\t\treturn 'x86_64-unknown-linux-gnu';\n\t\t\t\tcase 'arm64':\n\t\t\t\t\tif (isMusl()) {\n\t\t\t\t\t\treturn 'aarch64-unknown-linux-musl';\n\t\t\t\t\t}\n\n\t\t\t\t\treturn 'aarch64-unknown-linux-gnu';\n\n\t\t\t\tdefault:","sourceCodeStart":44,"sourceCodeEnd":80,"githubUrl":"https://github.com/remotion-dev/remotion/blob/78fe4bb3fdb5a2cd68724393d63cb223db333fa7/packages/compositor/build.ts#L44-L80","documentation":"Thrown by getTarget() when the build runs on macOS (process.platform === 'darwin') but process.arch is neither 'x64' nor 'arm64'. The Rust targets aarch64-apple-darwin and x86_64-apple-darwin are the only supported macOS architectures.","triggerScenarios":"Building the compositor on macOS with an unexpected process.arch (e.g. ia32 from a 32-bit Node build, or a future architecture not yet handled).","commonSituations":"Running a 32-bit Node.js on macOS; an exotic/preview architecture; a misreported arch from a containerized environment.","solutions":["Use a 64-bit Node.js (x64 or arm64) on macOS, which covers all current Apple Silicon and Intel Macs.","Use the prebuilt compositor binaries shipped with Remotion instead of building.","Cross-compile from a supported host if you need a target not matching your local arch."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"if (process.platform === 'darwin' && process.arch !== 'x64' && process.arch !== 'arm64') {\n  throw new Error(`Unsupported macOS arch: ${process.arch}`);\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Run a 64-bit Node.js (x64 or arm64) on macOS.","Prefer prebuilt binaries over building from source.","Cross-compile from a supported host if you need a different target."],"tags":["compositor","build","macos","architecture"],"backgroundTag":null,"analyzedSha":"78fe4bb3fdb5a2cd68724393d63cb223db333fa7","analyzedAt":"2026-08-12T17:18:50.444Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}