remotion-dev/remotion · error · Error

Unsupported architecture on Linux: ${process.arch}

Error message

Unsupported architecture on Linux: ${process.arch}

What it means

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.

Source

Thrown at packages/compositor/build.ts:81

			}

		case 'linux':
			switch (process.arch) {
				case 'x64':
					if (isMusl()) {
						return 'x86_64-unknown-linux-musl';
					}

					return 'x86_64-unknown-linux-gnu';
				case 'arm64':
					if (isMusl()) {
						return 'aarch64-unknown-linux-musl';
					}

					return 'aarch64-unknown-linux-gnu';

				default:
					throw new Error(`Unsupported architecture on Linux: ${process.arch}`);
			}

		default:
			throw new Error(
				`Unsupported OS: ${process.platform}, architecture: ${process.arch}`,
			);
	}
};

const hasCargo = () => {
	try {
		execSync(`${where} cargo`);
		return true;
	} catch (err) {
		return false;
	}
};

View on GitHub (pinned to 78fe4bb3fd)

Solutions

1. Build on an x86_64 or aarch64 Linux host.
2. Use the prebuilt compositor binaries distributed with Remotion rather than building.
3. Cross-compile from a supported host targeting the unsupported architecture if absolutely required.

if (process.platform === 'linux' && process.arch !== 'x64' && process.arch !== 'arm64') {
  throw new Error(`Unsupported Linux arch: ${process.arch}`);
}

When it happens

Trigger: Building the compositor on Linux with an unsupported arch such as ia32 (32-bit), riscv64, ppc64le, or s390x.

Common situations: Building on an uncommon server architecture (ppc64le, s390x); using a 32-bit Node on a 64-bit kernel; CI on an exotic runner.

Related errors

• Unsupported architecture on Windows: ${process.arch}
• Unsupported architecture on macOS: ${process.arch}
• Unsupported OS: ${process.platform}, architecture: ${process
• Run "bun install-toolchain.ts" if you want to build all plat
• Toolchain for ${toolchain} not found. Run "node install-tool

AI-assisted analysis of remotion-dev/remotion@78fe4bb3fd (2026-08-12). Data as JSON: /api/errors/2f3879c5f3f98cef. Report an issue: GitHub.