{"record":{"id":"2f3879c5f3f98cef","repo":"remotion-dev/remotion","slug":"unsupported-architecture-on-linux-process-arch","errorCode":null,"errorMessage":"Unsupported architecture on Linux: ${process.arch}","messagePattern":"Unsupported architecture on Linux: (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/compositor/build.ts","lineNumber":81,"sourceCode":"\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:\n\t\t\t\t\tthrow new Error(`Unsupported architecture on Linux: ${process.arch}`);\n\t\t\t}\n\n\t\tdefault:\n\t\t\tthrow new Error(\n\t\t\t\t`Unsupported OS: ${process.platform}, architecture: ${process.arch}`,\n\t\t\t);\n\t}\n};\n\nconst hasCargo = () => {\n\ttry {\n\t\texecSync(`${where} cargo`);\n\t\treturn true;\n\t} catch (err) {\n\t\treturn false;\n\t}\n};\n","sourceCodeStart":63,"sourceCodeEnd":99,"githubUrl":"https://github.com/remotion-dev/remotion/blob/78fe4bb3fdb5a2cd68724393d63cb223db333fa7/packages/compositor/build.ts#L63-L99","documentation":"Thrown by getTarget() when the build runs on Linux (process.platform === 'linux') but process.arch is neither 'x64' nor 'arm64'. Supported Linux targets are x86_64 and aarch64, each further split into musl/gnu via the isMusl() check.","triggerScenarios":"Building the compositor on Linux with an unsupported arch such as ia32 (32-bit), riscv64, ppc64le, or s390x.","commonSituations":"Building on an uncommon server architecture (ppc64le, s390x); using a 32-bit Node on a 64-bit kernel; CI on an exotic runner.","solutions":["Build on an x86_64 or aarch64 Linux host.","Use the prebuilt compositor binaries distributed with Remotion rather than building.","Cross-compile from a supported host targeting the unsupported architecture if absolutely required."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"if (process.platform === 'linux' && process.arch !== 'x64' && process.arch !== 'arm64') {\n  throw new Error(`Unsupported Linux arch: ${process.arch}`);\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Build on x86_64 or aarch64 Linux only.","Use the prebuilt compositor binaries otherwise.","Avoid 32-bit or uncommon-arch Node builds for native compilation."],"tags":["compositor","build","linux","architecture"],"backgroundTag":null,"analyzedSha":"78fe4bb3fdb5a2cd68724393d63cb223db333fa7","analyzedAt":"2026-08-12T17:18:50.444Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}