docs(wiki): Periphery v2.2.0 --user installer defaults root_directory=/etc/komodo

Lab box (park-test) crash-looped: panic writing the agent key to
/etc/komodo/keys/periphery.key (Permission denied). Gotcha #9 was framed
as a hand-config hazard; v2.2.0's installer now writes the system-style
default even with --user. §7a: verify root_directory after every
install + sed fix + reset-failed/restart; user-unit vs sudo note; the
onboarding key survives a pre-connect crash.

Claude-Session: https://claude.ai/code/session_01Xcm6ikLgGoCxxHrxtjkk5V
This commit is contained in:
2026-07-07 09:34:00 +02:00
parent 3a186d29df
commit ee61c24bb9
2 changed files with 20 additions and 2 deletions
+10
View File
@@ -2467,3 +2467,13 @@ Ubuntu's perl adduser/deluser tooling rejects the hyphenated username. [[applian
§5c now uses `gpasswd -d <operator> sudo|lxd|lpadmin` (shadow-suite, no perl sanitize) and notes
that group removal applies at NEXT login — the auto-login operator session keeps old memberships
until reboot/relog, so verify `groups` from inside the session afterwards.
## [2026-07-07] update | Periphery v2.2.0 --user installer writes /etc/komodo root_directory
Lab test box (park-test): periphery crash-looped at startup — panic writing the private key to
/etc/komodo/keys/periphery.key, Permission denied. Gotcha #9 was documented as a hand-config
hazard, but v2.2.0's installer now DEFAULTS root_directory to /etc/komodo even with --user (the
June park-buzi install defaulted under $HOME). [[appliance-provisioning]] §7a now says: verify
root_directory after every install + the sed one-liner fix; also notes `sudo systemctl restart
periphery` → "unit not found" (user unit) and that the single-use onboarding key survives a
pre-connect crash.