Skip to main content

Build workers

A build worker is a long-lived process that enrolls with AURCache, claims build jobs, builds each package, and uploads the result. Workers talk to the server over mutual TLS on port 8083, so a worker can live in the same compose stack, on another machine, or on another architecture.

WorkerHow it buildsStatus
Split chroot workerEach package in its own devtools chrootSupported — this is what every setup wants
Legacy container builderEach package in a reused containerDeprecated, continuity only
Demo workerCompletes every job with synthetic packagesDemo instance only
Hybrid imageServer and a worker in one containerDeprecated, continuity only

A worker starts from its environment variables. Its policy and tuning settings — concurrency, build limits, cache budgets, timeouts — can then be set for it from AURCache, on the worker's own page, and reach it without a restart. Everything else (its identity, its paths, what a build may reach) stays on the machine. See the split chroot worker for the full reference and Managing workers for day-to-day operation. To write a worker of your own, see the worker protocol.