From 34c78f6d7174b9c639a585de2cbe40569476dc21 Mon Sep 17 00:00:00 2001 From: Timothy Kim Date: Wed, 8 Apr 2026 19:20:04 -0400 Subject: [PATCH] updates documentation for beszel --- CLAUDE.md | 1 + README.md | 1 + RUNBOOK.md | 2 +- 3 files changed, 3 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index 2ef4ad9..58c534c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -19,6 +19,7 @@ Recovery steps are in `RUNBOOK.md`. Repo overview and workflows are in `README.m - **Secrets in .env files**: All secrets (DB passwords, API keys, tokens) live in `.env` files under each app's `docker//` directory on the server. These are gitignored (`**/.env` in root `.gitignore`). The `.env` files are included in the USB backup. If the backup is lost, all secrets can be recreated from Bitwarden. The `system/msmtprc` in the repo has its password REDACTED -- the real one is only on the server. - **ZFS parent dataset mountpoints**: Pools have parent datasets (e.g., `nextcloud`, `threeteras`) that create mountpoints like `/mnt/nextcloud`. These are empty and expected — do not delete them. - **msmtp**: Replaces sendmail for cron MAILTO and smartd email alerts. Configured via `/etc/msmtprc` (Fastmail SMTP). The symlink `/usr/sbin/sendmail -> /usr/bin/msmtp` is set up in recovery step 2. +- **Beszel agent**: System monitoring agent that reports to the beszel hub on hantim (`beszel.hantim.net`). Uses host network, listens on port 45876. No nginx proxy — it's not a web app. - **hantim-server**: Sister repo with similar nginx/certbot patterns. Located at `~/dev/hantim-server`. Useful as reference for deploy patterns. ## Remotes diff --git a/README.md b/README.md index eed72d7..e11be83 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,7 @@ docker/ Docker app configs (compose files, nginx confs) jellyfin/ Media server garage/ S3-compatible storage minecraft/ MCSManager + beszel-agent/ System monitoring agent (reports to beszel.hantim.net) smb/ Samba share (ZFS mountpoint, not in git) system/ System config snapshots (smb.conf, sanoid.conf, firewalld, etc.) ``` diff --git a/RUNBOOK.md b/RUNBOOK.md index f5b5112..be9e2b7 100644 --- a/RUNBOOK.md +++ b/RUNBOOK.md @@ -197,7 +197,7 @@ Deploy each app (nginx is already running and will return 502 until they start): ```bash # Add any new apps that have been added since this was written -for app in nextcloud gitea jellyfin garage minecraft; do +for app in nextcloud gitea jellyfin garage minecraft beszel-agent; do cd /opt/argento/docker/$app docker compose pull docker compose build