The Omarchy Robots Manual

Chapter 2

Getting started

The fastest way to meet Omarchy Robots is to run it as a virtual machine. It is the same system that goes on a Jetson, minus the NVIDIA layer.

What you need

Run the robot

git clone https://github.com/promaaa/omarchy-robots
cd omarchy-robots
nix run .#vm

The VM boots through UEFI and systemd-boot, exactly like the hardware does. Its serial console is your terminal, and it logs you in as the administrator.

Now ask the system whether it is healthy:

sudo omarchy-robot validate

Every check prints PASS, FAIL, SKIPPED or NOT_APPLICABLE. On the VM the Jetson checks are not applicable, and that is expected. When you’re done:

sudo poweroff        # leaves QEMU

The VM keeps its disk in robot.qcow2 in the current directory. Delete that file to start over from scratch.

Log in over SSH instead

Put your public key in robot.nix before you start the VM:

admin.sshKeys = [ "ssh-ed25519 AAAA... you@laptop" ];

Then nix run .#vm and, from another terminal:

ssh -p 2222 admin@localhost

Without a clone

nix run github:promaaa/omarchy-robots#vm

The repository is private for now, so Nix needs a GitHub token to fetch it:

nix --option access-tokens github.com=$(gh auth token) run github:promaaa/omarchy-robots#vm

Next

Open robot.nix and change something. The time zone is a good first edit, and Updates and rollback shows how to deploy it.