NixOS configuration for Mononoke NAS (flake-based)
  • Nix 97.1%
  • Python 1.8%
  • Shell 1%
  • Makefile 0.1%
Find a file
j7 05af4ca6eb nextcloud: drop removed adminuser/adminpassFile options; adopt nixpkgs 4fe25e12eb9f [6.6.42]
nixpkgs 4fe25e12eb9f REMOVED services.nextcloud.config.adminuser and
config.adminpassFile (both are now mkRemovedOptionModule). Setting them
trips the module assertion, which fails system.build.toplevel evaluation
and blocks EVERY nixos-rebuild on this host -- the failure the
weekly-housekeeping cron has reported since 2026-11-08.

The options only ever fed nextcloud-setup.service (first run). The admin
account already exists in the database (j7 / Jason Gatewood, san / San
Mononoke, both in the admin group), so removing them changes nothing at
runtime.

Nextcloud stays ENABLED and SERVING per J7's 2026-11-10 directive to
pause full deactivation until he has tested.

Verified: nix flake check --no-build --impure -> all checks passed;
toplevel --dry-run evaluates through to the full derivation listing;
status.php reports installed:true maintenance:false version 33.0.9.1.

Co-Authored-By: San <san@localhost>
2026-11-10 15:19:46 -05:00
.kilo/plans mononoke: fix tailscale-serve failure + clear rebuild warnings [2026-08-23] 2026-08-23 16:32:49 -04:00
data/index.bleve mononoke-lcd: 6-screen rotation, Tailscale IP, row1 recovery 2026-05-12 22:37:16 -04:00
nix nextcloud: drop removed adminuser/adminpassFile options; adopt nixpkgs 4fe25e12eb9f [6.6.42] 2026-11-10 15:19:46 -05:00
scripts mononoke: phase1a-v6 C1 nixosTest files + C3 preflight script [CLASS 3] 2026-07-02 11:27:18 -04:00
secrets mononoke: fix tailscale-serve failure + clear rebuild warnings [2026-08-23] 2026-08-23 16:32:49 -04:00
tests mononoke: phase1a-v6 C1 nixosTest files + C3 preflight script [CLASS 3] 2026-07-02 11:27:18 -04:00
.gitignore mononoke: bot-screen cua-driver X libs + commit 09-28..10-04 drift [2026-10-09] 2026-10-09 21:04:11 -04:00
AGENTS.md mononoke: record OpenCloud 9130/9131 and the Hermes Webapp on :9120 in the port registry [2026-11-08] 2026-11-08 13:45:11 -05:00
CHANGELOG.md nextcloud: drop removed adminuser/adminpassFile options; adopt nixpkgs 4fe25e12eb9f [6.6.42] 2026-11-10 15:19:46 -05:00
configuration.nix disk-cleanup: add weekly cleanup service + module 2026-09-09 03:30:13 -04:00
flake.lock nextcloud: drop removed adminuser/adminpassFile options; adopt nixpkgs 4fe25e12eb9f [6.6.42] 2026-11-10 15:19:46 -05:00
flake.nix nix: remove obsolete trusted-flakes setting (Nix 2.34 rejects it) 2026-09-06 21:12:45 -04:00
hardware-configuration.nix Migration: Hermes to Mononoke - remove duplicate configs, plaintext secrets, switch to podman 2026-04-03 17:17:20 -04:00
README.md weekly-housekeeping fix: add /run/wrappers/bin to sudo PATH, update journald extraConfig, fix tailscale tarball path 2026-09-20 08:05:16 -04:00

MononokeNAS NixOS Configuration

This repository contains the declarative NixOS configuration for the Mononoke NAS system.

Structure

  • flake.nix — Flake entry point
  • configuration.nix — Main system config
  • CHANGELOG.md — Release history
  • secrets/ — Age-encrypted secrets (gitignored)
  • nix/hosts/ — Host-specific configs
  • nix/modules/ — Reusable NixOS modules
  • nix/services/ — Service definitions
  • nix/overlays/ — Per-package Nix overrides (e.g. bun-1.4.0.nix pins pkgs.bun to oven-sh/bun v1.4.0; required by omp from pkgs.llm-agents)

Kitty over SSH

SSH clients running kitty set TERM=xterm-kitty. The system now ships an xterm-kitty-terminfo package (nix/users/san.nix, compiled from kitty's own terminfo/kitty.terminfo — pkgs.kitty.terminfo is empty in nixos-26.05). Without it, zsh prints can't find terminal definition for xterm-kitty on login and prompt rendering degrades. Per-user fallback: compile into ~/.terminfo with tic -x -o ~/.terminfo kitty.terminfo.

Quick Commands


sudo nixos-rebuild switch --flake .#mononoke --impure
systemctl status hermes-buzz-acp-yakkuru    # check any wolf
journalctl -u hermes-buzz-acp-<profile> -f  # live logs

Agents

  • Mononoke: Primary NAS agent (podman container)
  • Ashitaka: TUI agent for NixOS ops
  • Yoseba: VPS bastion

Hermes Agent Profiles (buzz-acp transport)

All 11 Hermes profiles connect to the Buzz relay via buzz-acp (Block's ACP harness binary). Each profile has a dedicated NixOS systemd service:

Service unit Profile
hermes-buzz-acp-default san / default identity
hermes-buzz-acp-ashitaka ashitaka
hermes-buzz-acp-ishii ishii
hermes-buzz-acp-jigo jigo
hermes-buzz-acp-kohroku kohroku
hermes-buzz-acp-mokku mokku
hermes-buzz-acp-moro moro
hermes-buzz-acp-nago nago
hermes-buzz-acp-okkoto okkoto
hermes-buzz-acp-toki toki
hermes-buzz-acp-yakkuru yakkuru

Module: nix/services/buzz-acp-agents.nix
Keys: agenix-encrypted at secrets/buzz-acp-<profile>-key.age, decrypted to /run/agenix/buzz-acp-<profile>-key at boot (mode 0400, owner san).
Keys are the original Nostr private keys — no rotation, same pubkeys, channel membership intact.

Migration: 2026-08-20 — transport-only migration from native Hermes gateway plugin. See wiki: operations/buzz-acp-migration-2026-08-20.md

Cross-pack author allowlist (respondToAllowlist)

Each hermes-buzz-acp-*.service daemon wakes on @-mentions from pubkeys in respondToAllowlist (CSV, owner implicit). Widened from a single pubkey (Toyo) to a 16-key cross-pack list on 2026-08-23 (see nix/services/buzz-acp-agents.nix). Roll out via:

sudo cp /etc/nixos/nix/services/buzz-acp-agents.nix{,.bak.$(date +%Y%m%d-%H%M%S)}
# edit the `respondToAllowlist = "..."` literal, save
sudo nixos-rebuild switch --flake /etc/nixos#mononoke --impure
sudo systemctl daemon-reload
for p in default ashitaka ishii jigo kohroku mokku moro nago okkoto toki yakkuru; do
  sudo systemctl restart hermes-buzz-acp-${p}.service
done

Verify each daemon inherited the new list:

for p in default ashitaka ishii jigo kohroku mokku moro nago okkoto toki yakkuru; do
  echo "=== $p ==="
  ps -ef | grep "agent-args.*${p} " | grep -v grep | grep -oE 'respond-to-allowlist [^ ]+'
done

(default daemon's --agent-args=acp has no profile prefix; use systemctl status hermes-buzz-acp-default.service to inspect its ExecStart if the grep returns empty.)

Currently disabled

  • pkgs.opencode (1.17.4) and nix/services/opencode.nix — disabled 2026-08-25 because upstream nixpkgs-unstable's opencode derivation segfaults in its post-build smoke test under bun-1.4.0 (exit 139, no stack). The previously cached opencode-1.17.4 binary at /nix/store/g5bjc480izwmpkar83xxhs2vyli0vq9j-opencode-1.17.4/bin/opencode still works if invoked directly. Re-enable once a fixed opencode derivation ships in nixpkgs-unstable, or pin to a known-good version via overlay. See CHANGELOG.md 6.6.18.