{"record":{"id":"e64d1f58cbbbc4e3","repo":"remotion-dev/remotion","slug":"unsupported-architecture-on-windows-process-arc","errorCode":null,"errorMessage":"Unsupported architecture on Windows: ${process.arch}","messagePattern":"Unsupported architecture on Windows: (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/compositor/build.ts","lineNumber":50,"sourceCode":"\nconst targets = [\n\t'x86_64-pc-windows-gnu',\n\t'x86_64-unknown-linux-musl',\n\t'aarch64-unknown-linux-gnu',\n\t'x86_64-unknown-linux-gnu',\n\t'aarch64-apple-darwin',\n\t'x86_64-apple-darwin',\n\t'aarch64-unknown-linux-musl',\n];\n\nexport const getTarget = () => {\n\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()) {","sourceCodeStart":32,"sourceCodeEnd":68,"githubUrl":"https://github.com/remotion-dev/remotion/blob/78fe4bb3fdb5a2cd68724393d63cb223db333fa7/packages/compositor/build.ts#L32-L68","documentation":"Thrown by getTarget() in packages/compositor/build.ts when the build is running on Windows (process.platform === 'win32') but process.arch is not 'x64'. The native compositor cross-compiles only for the x86_64-pc-windows-gnu target, so any other Windows architecture is unsupported at build time.","triggerScenarios":"Running the compositor build script on Windows on an architecture other than x64, e.g. Windows on ARM (process.arch === 'arm64') or a 32-bit (ia32) Node build.","commonSituations":"Building the native binary on a Windows-on-ARM device; running a 32-bit Node.js on Windows; a CI runner reporting an unexpected arch.","solutions":["Build on a Windows x64 host or use the prebuilt compositor binaries distributed with Remotion.","If you must build on Windows ARM, run x64 Node via Rosetta-equivalent emulation or use a cross-compile environment.","For local development prefer the prebuilt binaries instead of building from source."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"// Before building, assert a supported platform/arch combination.\nconst supported =\n  (process.platform === 'win32' && process.arch === 'x64') ||\n  (process.platform === 'darwin' && (process.arch === 'x64' || process.arch === 'arm64')) ||\n  (process.platform === 'linux' && (process.arch === 'x64' || process.arch === 'arm64'));\nif (!supported) throw new Error(`Unsupported build host: ${process.platform}/${process.arch}`);","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Use the prebuilt compositor binaries shipped with Remotion for normal development.","Only build from source on supported host architectures (Windows x64, macOS x64/arm64, Linux x64/arm64).","Pin CI builders to a supported arch."],"tags":["compositor","build","windows","architecture"],"backgroundTag":null,"analyzedSha":"78fe4bb3fdb5a2cd68724393d63cb223db333fa7","analyzedAt":"2026-08-12T17:18:50.444Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}