Deploy Hermes Bootstrap to hardware

deployment-skillskillsetup L42
steezkelly/hermes-bootstrap
What it does

Deploy NixOS system via USB boot or live installer environment

Best for

When deploying Hermes agents to hardware that requires reproducible NixOS configuration and offline-first bootstrap paths

Inputs
  • · target disk path (e.g. /dev/nvme0n1)
  • · hermes-bootstrap repository
Outputs
  • · deployed NixOS system
  • · flake configuration applied
  • · system ready for operation
Requires
  • · NixOS minimal ISO
  • · nix flake
  • · nixos-rebuild
Preconditions
  • · USB stick or network boot
  • · Live disk verified with lsblk
  • · Network connectivity in installer
Failure modes
  • · SquashFS I/O errors on sustained USB reads
  • · WiFi interface name mismatch between machines
  • · Ventoy gray screen timeout
  • · Network unreachable in NixOS live
Trust signals
  • · nixos-enter + nixos-rebuild proven more reliable than nixos-install --flake on live USB
  • · Documented failure modes with recovery steps