Files

dtoro f5cd320433 Bootstrap Homelab-Docs wiki

Initial documentation of the hubris Proxmox homelab as a cross-linked
markdown wiki. Per-node pages, cross-cutting infrastructure pages, an
investigation log, and an operations cheatsheet. Each node and topic
ends with a Changelog section so changes can be tracked in-place going
forward.

Refreshed against live state on 2026-04-28 — 14 active LXCs (109
syncthing currently stopped) + 1 VM (108 haos). Reflects post-A/B-test
state of the 2026-04-21 hubris crash-loop investigation.

2026-04-28 22:53:09 +02:00

3.5 KiB

Raw Blame History

123 — `claudio-bot`

Matrix-resident control plane. Bot account @claudio:avispero joined to a private room; accepts slash commands and natural language; relays infra notifications.

At a glance

Hostname: claudio-bot
IP: 192.168.8.230
Privilege: unprivileged
Resources: 1 core / 512 MiB RAM / 8 GiB rootfs
Mounts: none from /mnt/library
Public hostname: none

Stack

Repo dtoro/claudio-bot, checkout at /opt/claudio-bot, systemd unit claudio-bot.service. Connects to Matrix at http://192.168.8.239:8008 (direct LAN to synapse (118), avoids hairpin-NAT TLS issue on matrix.hubris.network).

Room: !dEUVJArVKPorxHHJZK:avispero (invite-only, @dtoro:avispero allowed).

Configuration

Secrets at /etc/claudio-bot/ (mode 600):

config.yaml
matrix.token
anthropic.key
lmstudio.key
ipc.token

Deploy git creds at /etc/claudio-deploy/git-credentials.

LLM backend (pluggable)

llm.backend in config.yaml:

anthropic — Claude API via anthropic.key
lmstudio — OpenAI-compat HTTP via lmstudio.key (bearer)

Currently set to lmstudio → google/gemma-4-e4b on the Mac mini at 192.168.8.174:1234 (since 2026-04-25). Switch back with backend: + systemctl restart claudio-bot. Original config saved at /etc/claudio-bot/config.yaml.bak. The LM Studio agent in bot_core/lmstudio.py translates Anthropic → OpenAI tool definitions.

IPC

http://192.168.8.230:9090/{notify,propose,status}. Header X-Bot-Token must match /etc/claudio-bot/ipc.token. Used by:

claudio-monitor on hubris for edge-triggered alerts (token in /etc/claudio-monitor/bot.token)
The (currently disabled) restic backup wrapper (token in /etc/restic/bot.token)

Token files at the source side must hold the same value as /etc/claudio-bot/ipc.token — rotate together.

Plugins

Module under plugins/<name>.py exposing a Plugin class; add <name> to plugins: in config.yaml. Plugins can register slash commands, Claude tools, and on_notify / on_proposal_response hooks.

Active plugins:

system — ping, help, status, list_plugins
backup — ingests /notify from the backup wrapper (currently silent — backups disabled)
monitor — /monitor status, /monitor history [N], /monitor clear <key>. Tools: get_alerts, get_monitor_history for NL queries via Claude.

Auto-deploy

Push to dtoro/claudio-bot → gitea webhook → http://192.168.8.230:9797/deploy → pull + pip install + restart. Same shape as caddy-conf.

app.ini ALLOWED_HOST_LIST on gitea includes 192.168.8.230.

Changelog

2026-04-28 — wiki entry created

Initial documentation.

2026-04-25 — LLM backend switched to LM Studio

backend: lmstudio → google/gemma-4-e4b on the Mac mini. Anthropic key still present so the swap is reversible by flipping the config field.

2026-04-21 — `monitor` plugin added

Receives events from claudio-monitor. Slash commands + tools registered. See dtoro/claudio-bot commit e56da25.

2026-04-20 — claudio-bot deployed

LXC 123 provisioned. Repo, systemd unit, Matrix wiring, system + backup plugins, IPC server.

3.5 KiB Raw Blame History

123 — claudio-bot