Operator Quickstart

1. Install

Homebrew is the macOS path (Apple Silicon). The binary is unsigned — macOS may require a one-time xattr -cr bypass.

Linux (x86_64 / aarch64, glibc) — the supported path is the installer published with each release:

decent upgrade re-runs the right one for your platform. Linux notes: both architectures render, but only x86_64 can use the GPU path (on ARM, Remotion substitutes a Playwright chromium and the node reports gpu: false — by design); the x86_64 GPU path needs a DRM render node (/dev/dri/renderD*); Alpine and other musl distributions are not supported.

2. Pair your Mac

Sign in to your farm account at decent-render.farm/login, then:

1. Go to Devices
2. Click Pair New Device and name your machine
3. Copy the one-time pairing token

3. Go online — daemon or foreground

Run as a daemon:

This installs a launchd daemon so the node survives reboots.

Or in the foreground:

Real jobs need explicit consent: pass --allow-real-jobs, or flip the consent toggle in the app/TUI. Never run the daemon and the foreground node at the same time with one device token. Check status with:

4. Verify you're online

The status command should show:

Your machine is now eligible to receive render jobs. Jobs arrive automatically when the farm has work matching your capabilities (GPU, etc).

Commands reference

Renamed from decent-node: the CLI is decent as of v0.0.5. A decent-node shim still forwards to it on macOS and is removed at v0.1; decent install migrates the token and the daemon label for you.