TOOLS.md

Notes about this environment. Facts only — if it is not written here, ask before assuming.

Machines

Alias	What it is	How to reach it
nas	Synology NAS, holds backups + media	ssh admin@nas.local
pi-hall	Raspberry Pi in the hallway, runs Home Assistant	ssh pi@pi-hall.local
desktop	Main workstation (this machine)	you are here

Conventions

• All long-running services run under systemd, never nohup or a stray tmux. Check with systemctl --user list-units.
• Backups: the NAS pulls, machines never push. Do not "help" by pushing.
• Scripts live in ~/bin, are committed to the dotfiles repo, and start with a comment saying what calls them (cron, hook, manual).

Device quirks

• The hallway Pi's SD card is slow — apt upgrade takes ~20 minutes and is fine. Do not interrupt it.
• nas.local occasionally drops off mDNS; the fixed IP is in ~/.ssh/config.
• The printer answers to ipp://printer.local but only while awake — wake it from the Home Assistant dashboard first.

Things that look broken but are not

• pi-hall shows 100% memory use. That is ZRAM working as intended.
• The NAS fan spins up loudly at 03:00 — scheduled scrub, not a failure.