remotion-dev/remotion · error · Error

Unsupported architecture on macOS: ${process.arch}

Error message

Unsupported architecture on macOS: ${process.arch}

What it means

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.

Source

Thrown at packages/compositor/build.ts:62

	switch (process.platform) {
		case 'win32':
			switch (process.arch) {
				case 'x64':
					return 'x86_64-pc-windows-gnu';
				default:
					throw new Error(
						`Unsupported architecture on Windows: ${process.arch}`,
					);
			}

		case 'darwin':
			switch (process.arch) {
				case 'x64':
					return 'x86_64-apple-darwin';
				case 'arm64':
					return 'aarch64-apple-darwin';
				default:
					throw new Error(`Unsupported architecture on macOS: ${process.arch}`);
			}

		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:

View on GitHub (pinned to 78fe4bb3fd)

Solutions

1. Use a 64-bit Node.js (x64 or arm64) on macOS, which covers all current Apple Silicon and Intel Macs.
2. Use the prebuilt compositor binaries shipped with Remotion instead of building.
3. Cross-compile from a supported host if you need a target not matching your local arch.

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

When it happens

Trigger: 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).

Common situations: Running a 32-bit Node.js on macOS; an exotic/preview architecture; a misreported arch from a containerized environment.

Related errors

• Unsupported architecture on Windows: ${process.arch}
• Unsupported architecture on Linux: ${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/a80d7c6eaa0274c3. Report an issue: GitHub.