57fbf70b7c79bd41460b90008278bd8fbde4f647
systemd-networkd-wait-online fails on every boot of hl-fwdesk with "Timeout occurred while waiting for network connectivity" and status=1/FAILURE. The hermes VM runs on this host via services.hermenix (ari/hermenix flake input), and its fabric interfaces -- the bridge hermes-br and the tap vm-hermes -- are managed by systemd-networkd (10-hermes-br.network, 11-vm-hermes.network). networkd-managed links default to RequiredForOnline=yes, but those two links only gain carrier when the VM starts, which on the sampled boot was 0.2s after the 120s wait-online timeout fired. The only networkd link that never blocks is robotnix's own bridge, and the physical uplink enp191s0 is owned by NetworkManager, so it is invisible to networkd. The result is a unit that always burns the full timeout and then fails. hermenix now passes --ignore=hermes-br --ignore=vm-hermes to the unit, so it no longer treats the VM's fabric links as a condition for "online": with every candidate ignored the wait returns immediately instead of blocking and then failing. The unit itself stays enabled and anyInterface is untouched. The durable fix belongs in ari/hermenix: set RequiredForOnline = "no" on the hermes-br and vm-hermes .network files, the same way modules/nixos/server/robotnix/network.nix already does for the robotnix fabric. That repository is out of scope for this change; once it lands this ignoredInterfaces entry can be dropped. Found by hermenix from the fleet monitor's persistent failure record for unit:hub:systemd-networkd-wait-online.service.
…
NixOS System Configurations
Nix configs for all my machines: local desktops/laptops and homelab servers.
Repository Layout
nixos-setup/
├── bin/ # `skyg` CLI (see bin/ABOUTME.md)
│ ├── skyg # Bash shim → NuShell modules in bin/lib/
│ ├── temp-monitor # CPU/GPU temperature logger (see TEMP_MONITOR_README.md)
│ └── lib/ # Command modules: os, remote, secrets, ca, pkgs, flake, build, render, hm, net
├── configs/ # App configs per host, plus configs/pki (lab TLS certs)
├── pkgs/ # Custom packages (see pkgs/ABOUTME.md)
├── hosts/ # One folder per host (fwbook, hl-*, iso) + disko/hardware files
├── modules/
│ ├── main.nix # Entry point that wires all modules together
│ ├── core/ # Core system modules
│ ├── nixos/ # NixOS modules (desktop, server, common)
│ ├── home/ # Home Manager modules
│ ├── openwrt/ # OpenWrt config generator
│ └── *.nix # Shared helpers (lib, skyg-utils, internal-networking, …)
├── openwrt-routers/ # OpenWrt router configs (glmain)
├── secrets/ # agenix-encrypted secrets (keys listed in secrets.nix)
├── docs/ # Documentation
└── flake.nix # Flake definition
Using This Flake
Custom packages and helpers are exported for reuse:
{
inputs.nixos-setup.url = "github:skykanin/nixos-setup";
outputs = { nixos-setup, ... }:
let
pkgs = nixos-setup.lib.pkgs."x86_64-linux";
in {
environment.systemPackages = [ pkgs.niri-touchscreen-gestures ];
};
}
nixos-setup.lib also provides makeNixOs, makeHomeManagerUsers, makeIso, makeSdImage, and more.
Inside this repo, every package in pkgs/ is available as pkgs.<name> through the overlay.
The skyg CLI
bin/skyg is the main tool for this repo. Run skyg to list subcommands, or skyg <subcommand> --help for details.
Local system — skyg os
| Command | Description |
|---|---|
skyg os <action> |
Rebuild locally. Actions: test, dry-activate, run, switch, build, boot |
skyg os <action> --build-host <host> |
Build on another machine (e.g. --build-host fwdesk) |
skyg os rollback |
Go back to the previous generation |
Remote hosts — skyg remote
| Command | Description |
|---|---|
skyg remote <action> <target> |
Deploy to a remote host. Same actions as skyg os |
skyg remote install <target> |
Fresh install via nixos-anywhere using hosts/hl-<target>.disko.nix. Wipes disks. Asks you to type the hostname; refuses if NixOS is already installed unless --force-wipe |
skyg remote status <target> |
Show one host's status |
skyg remote status --all |
Show all hosts: generation, pending reboot, needs rebuild |
skyg remote boot-all |
Run boot on every online remote (skips this machine) |
skyg remote reboot-pending |
Reboot hosts whose booted system differs from the current one, one at a time, after confirmation |
Example: skyg remote switch bigbox1 deploys hl-bigbox1 to root@bigbox1.lab.internal.
Flake — skyg flake
| Command | Description |
|---|---|
skyg flake update [input] |
Update all inputs, or one, then show the flake.lock diff |
skyg flake check |
Run nix flake check --no-build |
skyg flake check-versions |
Check that all inputs use the same NixOS release |
Images and routers — skyg build
| Command | Description |
|---|---|
skyg build image <iso|pi1|pi2> |
Build an ISO or a Pi SD card image |
skyg build openwrt [router] [--dry-run] |
Deploy a router config (default glmain). --dry-run only renders to .tmp/ |
Home Manager — skyg hm
| Command | Description |
|---|---|
skyg hm switch [profile] |
Apply Home Manager config (default ari) |
skyg hm build [profile] |
Build Home Manager config |
Secrets — skyg secrets
| Command | Description |
|---|---|
skyg secrets / skyg secrets list |
List secret names |
skyg secrets show <secret> |
Decrypt to .tmp/unencrypted-<secret> |
skyg secrets edit <secret> [file] [--yaml] |
Edit and re-encrypt (--yaml validates first) |
skyg secrets compare <secret> |
Diff the working copy against the stored secret |
Lab CA — skyg ca
| Command | Description |
|---|---|
skyg ca init |
Create the root CA: key → secrets/lab-ca-key.age, cert → configs/pki/lab-ca.crt |
skyg ca issue <domain> --for <host> |
Issue a TLS cert: cert → configs/pki/<domain>.crt, key → secrets/<name>-tls-key.age |
Custom packages — skyg pkgs
| Command | Description |
|---|---|
skyg pkgs update --all |
Update every package that has an update.sh |
skyg pkgs update <pkg> [version] |
Update one package (latest, or a given version) |
Network — skyg net
| Command | Description |
|---|---|
skyg net check [device] |
Show NIC info and run a speed test on every device (or one). --no-speedtest skips the test |
skyg net last |
Show the results of the last skyg net check |
Other
| Command | Description |
|---|---|
skyg profiles |
List all profiles |
skyg profiles true |
List only remote (hl-*) profiles |
skyg render html-tpl <file> |
Preview a Gitea .tmpl on 127.0.0.1 (Ctrl+C to stop) |
Managing Secrets
Secrets are encrypted with agenix and stored in secrets/.
To give a new host access:
- Get its key:
cat /etc/ssh/ssh_host_ed25519_key.pub - Add it to
secrets.nixand to each secret'spublicKeys - Re-encrypt each affected secret:
skyg secrets show <name>, thenskyg secrets edit <name>
See secrets/ABOUTME.md and docs/agenix.md for more.
Host Profiles
- Local:
fwbook(Framework laptop) - Remote:
hl-bigbox1,hl-bigbox2,hl-fwdesk,hl-fws1,hl-minipc1,hl-minipc2,hl-minipc3,hl-pi1,hl-pi2,hl-terra1 - ISO:
iso(bootable installer)
See docs/hosts/README.md for per-host details.
Languages
Nix
58.8%
Nushell
9.7%
Lua
9.2%
Python
5.7%
QML
5.3%
Other
11.3%