remotion-dev/remotion · error · Error

Unsupported OS: ${process.platform}, architecture: ${process

Error message

Unsupported OS: ${process.platform}, architecture: ${process.arch}

What it means

Thrown by getTarget() when process.platform is not one of win32, darwin, or linux. These are the only platforms for which a Rust compositor target exists; anything else (e.g. freebsd, aix, sunos) is unsupported.

Source

Thrown at packages/compositor/build.ts:85

				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;
	}
};

const debug = process.argv.includes('--debug');
const mode = debug ? 'debug' : 'release';

const copyDestinations = {

View on GitHub (pinned to 78fe4bb3fd)

Solutions

1. Build on a supported OS (Windows, macOS, or Linux).
2. Use the prebuilt compositor binaries packaged with Remotion.
3. Cross-compile from a supported platform if you need a binary for a different environment.

if (!['win32', 'darwin', 'linux'].includes(process.platform)) {
  throw new Error(`Unsupported OS: ${process.platform}`);
}

When it happens

Trigger: Running the compositor build script on an OS Node reports as something other than Windows, macOS, or Linux.

Common situations: Building on FreeBSD, OpenBSD, AIX, or Solaris; a container/runtime reporting a non-standard platform string.

Related errors

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