The Omarchy Robots Manual

Chapter 3

robot.nix

robot.nix is the one file that declares a robot. Everything else in the repository is the system it configures.

# robot.nix
{
  omarchy.robot = {
    name = "robot";
    board = "orin-agx-devkit";   # or "vm", "orin-nano-super-devkit", "thor-agx-devkit", ...
    admin.sshKeys = [ "ssh-ed25519 AAAA... you@laptop" ];
    gpu.enable = true;           # CUDA and TensorRT samples for validation
    power.mode = 0;              # nvpmodel mode ID
    generations = 10;            # kept for rollback
  };
}

That’s a complete robot. The flake output for this file is .#robot.

Options

Every option lives under omarchy.robot. Types and defaults are in modules/options.nix, which is the reference if this page and the code ever disagree.

Option Default What it does
name "robot" Hostname. Lowercase letters, digits and dashes.
board "vm" What the robot runs on. See Boards. Changing boards is this one line.
storage.device /dev/vda on vm, /dev/nvme0n1 on a Jetson or pc The whole disk the installer erases and installs onto: an EFI partition and an ext4 root.
admin.user "admin" The administrator login. In wheel, with passwordless sudo.
admin.sshKeys [ ] Public keys that may log in as the administrator. A Jetson or pc board refuses to build without at least one, because nobody could ever log in.
network.address null (DHCP) Static IPv4 address with prefix, like "192.168.1.20/24".
network.gateway null Default gateway, only with a static address.
network.dns [ ] DNS servers, only with a static address.
timezone "UTC" Time zone of the clock and the logs, like "Asia/Seoul".
gpu.enable false Jetson only. Installs the NVIDIA GPU userspace and the CUDA and TensorRT samples that validate runs. Large.
power.mode null (board default) Jetson only. The nvpmodel mode ID applied at boot. IDs differ per board: nvpmodel -p --verbose on the robot lists them.
runtime.enable false Installs omarchy-runtime, the execution runtime (simulated for now), with /var/lib/omarchy-runtime/runs for its run directories. A command, not a service.
s2Link.enable, .address, .listenPort, .privateKeyFile, .port, .peer.address, .peer.publicKey (or .peer.publicKeyFile), .peer.endpoint off Carries the link to an S2 on another machine over a WireGuard tunnel; the runtime then reaches S2 through the tunnel only. See Security.
generations 10 Systems kept for rollback, between 2 and 100. Both the boot menu and the weekly garbage collection respect it.

Guard rails

The build stops with a plain message instead of producing a robot that can’t work:

Anything else

robot.nix is an ordinary NixOS module. When nothing under omarchy.robot fits, set any NixOS option right there:

{
  omarchy.robot = { ... };
  services.tailscale.enable = true;
}

Keep those additions few. The point of the file is that someone else can read it in a minute and know the machine.