Introduction

nix-hex-box is a nix-darwin module that configures an Apple Container based aarch64-linux remote builder for Nix.

The module is designed for Darwin hosts that want to offload Linux derivations to a local virtualized builder while keeping the host configuration declarative.

Current design highlights:

• installs Apple container from the official signed release package
• configures nix.buildMachines for ssh-ng://container-builder
• uses a pinned upstream docker.io/nixos/nix:<version> builder image
• manages durable state under ~/.local/state/hb
• supports an optional bridge for the root nix-daemon
• wakes the builder on demand for user-side SSH access through ProxyCommand
• supports guest-side idle shutdown and recovery-oriented health checks

This book documents the module itself. If you use nix-hex-box from another repo, that repo should only need a high-level integration guide.