|
|
@@ -4,14 +4,14 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
|
|
|
|
|
|
|
|
|
|
|
## Repository Overview
|
|
|
|
## Repository Overview
|
|
|
|
|
|
|
|
|
|
|
|
This repository manages a **homelab infrastructure** with self-hosted services running across 3 nodes using a **hybrid orchestration** model: Docker Swarm for core infrastructure services, standalone Docker Compose for isolated services.
|
|
|
|
This repository manages a **homelab infrastructure** with self-hosted services running across 3 nodes using **standalone Docker Compose** on all nodes. (Docker Swarm was fully dismantled on 2026-04-01.)
|
|
|
|
|
|
|
|
|
|
|
|
### Cluster Architecture
|
|
|
|
### Cluster Architecture
|
|
|
|
|
|
|
|
|
|
|
|
**Nodes:**
|
|
|
|
**Nodes:**
|
|
|
|
- **hf-pdocker-01** (192.168.86.192) - Swarm Manager, core infrastructure + Frigate NVR - **RESTORED (2026-03-08)**
|
|
|
|
- **hf-pdocker-01** (192.168.86.192) - Core infrastructure + Frigate NVR - **RESTORED (2026-03-08)**
|
|
|
|
- **hf-pdocker-02** (192.168.86.100) - Standalone Compose services (dev tools, utilities)
|
|
|
|
- **hf-pdocker-02** (192.168.86.100) - Dev tools, utilities
|
|
|
|
- **bart** (192.168.86.167) - Standalone Compose services (media stack, OpenVAS)
|
|
|
|
- **bart** (192.168.86.167) - Media stack, OpenVAS
|
|
|
|
|
|
|
|
|
|
|
|
**Synology NAS** (192.168.86.30) - Centralized NFS storage for all service data
|
|
|
|
**Synology NAS** (192.168.86.30) - Centralized NFS storage for all service data
|
|
|
|
|
|
|
|
|
|
|
@@ -20,47 +20,47 @@ This repository manages a **homelab infrastructure** with self-hosted services r
|
|
|
|
### Service Distribution
|
|
|
|
### Service Distribution
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
```
|
|
|
|
hf-pdocker-01 (Manager, 23GB RAM, i7-7700T, NVMe, HD 630 GPU) -- RESTORED (2026-03-08, hardware repaired)
|
|
|
|
hf-pdocker-01 (23GB RAM, i7-7700T, NVMe, HD 630 GPU) -- RESTORED (2026-03-08, hardware repaired)
|
|
|
|
├── [COMPOSE] Frigate NVR (:5000) -- OpenVINO GPU detector, 13 cameras active
|
|
|
|
├── [COMPOSE] Frigate NVR (:5000) -- OpenVINO GPU detector, 13 cameras active
|
|
|
|
├── [COMPOSE] Frigate-Notify v2 (:5199) -- MQTT->AI->Matrix notifications
|
|
|
|
├── [COMPOSE] Frigate-Notify v2 (:5199) -- MQTT->AI->Matrix notifications
|
|
|
|
├── [COMPOSE] clip-service (:5200) -- CLIP embeddings (ViT-L-14, CPU)
|
|
|
|
├── [COMPOSE] clip-service (:5200) -- CLIP embeddings (ViT-L-14, CPU)
|
|
|
|
├── [COMPOSE] Open WebUI (:3010) -- AI chat UI (Ollama + Anthropic backends)
|
|
|
|
|
|
|
|
├── [COMPOSE] Home Assistant (:8123)
|
|
|
|
├── [COMPOSE] Home Assistant (:8123)
|
|
|
|
├── [COMPOSE] ESPHome (:6052)
|
|
|
|
├── [COMPOSE] ESPHome (:6052)
|
|
|
|
├── [COMPOSE] Mosquitto (:1883, :8883)
|
|
|
|
├── [COMPOSE] Mosquitto (:1883, :8883)
|
|
|
|
├── [COMPOSE] Synapse/Matrix (:8008) + synapse-db (postgres) + wellknown (:8010)
|
|
|
|
├── [COMPOSE] Synapse/Matrix (:8008) + synapse-db (postgres) + wellknown (:8010)
|
|
|
|
├── [COMPOSE] Guacamole (:8199) + guacd + guacamole-db (mysql, LOCAL /var/lib/guacamole-db)
|
|
|
|
├── [COMPOSE] Guacamole (:8199) + guacd + guacamole-db (mysql, LOCAL /var/lib/guacamole-db)
|
|
|
|
├── [COMPOSE] AI Agents (margaret:18790, spirit:18795 [infra ops], clippy:18800, bob:18810, travis:18815)
|
|
|
|
├── [COMPOSE] AI Agents (margaret:18790, spirit:18795 [infra ops])
|
|
|
|
├── [COMPOSE] Traefik (reverse proxy, ports 80/443/8090)
|
|
|
|
├── [COMPOSE] Traefik (reverse proxy, ports 80/443/8090)
|
|
|
|
├── [COMPOSE] AdGuard Home (:3000, :53)
|
|
|
|
├── [COMPOSE] AdGuard Home (:3000, :53)
|
|
|
|
├── [COMPOSE] Monitoring (Grafana :3001, Prometheus :9095, Alertmanager :9093, InfluxDB :8086, Blackbox :9115, matrix-receiver :9094)
|
|
|
|
├── [COMPOSE] Monitoring (Grafana :3001, Prometheus :9095, Alertmanager :9093, InfluxDB :8086, Blackbox :9115, matrix-receiver :9094)
|
|
|
|
├── [COMPOSE] Farm Manager API (:8888) -- dashboard + API server
|
|
|
|
├── [COMPOSE] Farm Manager API (:8888) -- dashboard + API server
|
|
|
|
├── [COMPOSE] Farm Agent (:8889)
|
|
|
|
├── [COMPOSE] Farm Agent (:8889)
|
|
|
|
├── [SWARM] Telegraf (global), Node-exporter (global)
|
|
|
|
├── [COMPOSE] Rongorongo (:8181) -- static HTML/JS decipherment engine (Anthropic API direct from browser)
|
|
|
|
|
|
|
|
├── [REMOVED] VoiceCoach -- moved to GPU machine (192.168.86.150) 2026-04-04
|
|
|
|
|
|
|
|
├── [COMPOSE] Node-exporter (:9100) -- standalone with pid:host
|
|
|
|
|
|
|
|
├── [COMPOSE] Telegraf -- metrics collection to InfluxDB
|
|
|
|
├── [CRON] sync-frigate-to-nas (daily 2am), cleanup-frigate-media (weekly Sun 3am), restart-frigate (daily 4am)
|
|
|
|
├── [CRON] sync-frigate-to-nas (daily 2am), cleanup-frigate-media (weekly Sun 3am), restart-frigate (daily 4am)
|
|
|
|
├── 5TB USB disk at /mnt/frigate-recordings (Frigate recordings storage)
|
|
|
|
├── 5TB USB disk at /mnt/frigate-recordings (Frigate recordings storage)
|
|
|
|
|
|
|
|
|
|
|
|
bart (Worker, 15GB RAM, i5-4570T, HDD)
|
|
|
|
bart (15GB RAM, i5-4570T, HDD)
|
|
|
|
├── [COMPOSE] Media Stack (Jellyfin, Sonarr, Radarr, SABnzbd, NZBHydra2, Jellyseerr)
|
|
|
|
├── [COMPOSE] Media Stack (Jellyfin, Sonarr, Radarr, SABnzbd, NZBHydra2, Jellyseerr)
|
|
|
|
├── [COMPOSE] OpenVAS (vulnerability scanner)
|
|
|
|
├── [COMPOSE] OpenVAS (vulnerability scanner)
|
|
|
|
├── [COMPOSE] Onyx (:3005) -- AI document search/RAG (Ollama backend: llava:13b on 192.168.86.196)
|
|
|
|
|
|
|
|
├── [COMPOSE] Farm Agent (:8889)
|
|
|
|
├── [COMPOSE] Farm Agent (:8889)
|
|
|
|
|
|
|
|
├── [COMPOSE] Node-exporter (:9100) -- standalone with pid:host
|
|
|
|
|
|
|
|
├── [COMPOSE] Telegraf -- metrics collection to InfluxDB
|
|
|
|
├── [COMPOSE] Watchtower
|
|
|
|
├── [COMPOSE] Watchtower
|
|
|
|
├── [SWARM] Telegraf (global), Node-exporter (global)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
hf-pdocker-02 (Worker, 7.6GB RAM, i7-6700T, HDD)
|
|
|
|
hf-pdocker-02 (7.6GB RAM, i7-6700T, HDD)
|
|
|
|
├── [COMPOSE] Unifi + unifi-db (MongoDB)
|
|
|
|
├── [COMPOSE] Unifi + unifi-db (MongoDB)
|
|
|
|
├── [COMPOSE] Gitea + gitea-db (PostgreSQL)
|
|
|
|
├── [COMPOSE] Gitea + gitea-db (PostgreSQL)
|
|
|
|
├── [COMPOSE] Semaphore + semaphore-db (MySQL)
|
|
|
|
├── [COMPOSE] Semaphore + semaphore-db (MySQL)
|
|
|
|
├── [COMPOSE] Wiki.js + wikijs-db (PostgreSQL)
|
|
|
|
├── [COMPOSE] Wiki.js + wikijs-db (PostgreSQL)
|
|
|
|
├── [COMPOSE] Vaultwarden, Actual Budget, MCPO, Trivy
|
|
|
|
├── [COMPOSE] Vaultwarden, Actual Budget, MCPO, Trivy
|
|
|
|
├── [COMPOSE] SearXNG (:8888) -- self-hosted meta-search engine (Onyx web search backend)
|
|
|
|
├── [COMPOSE] n8n + n8n-db (PostgreSQL) -- workflow automation
|
|
|
|
├── [COMPOSE] Unstructured API (:8000) -- document parsing for Onyx file ingestion
|
|
|
|
|
|
|
|
├── [COMPOSE] n8n + n8n-db (PostgreSQL) -- Clippy workflow automation
|
|
|
|
|
|
|
|
├── [COMPOSE] NetClaw/Aaron (:1179) -- AI network agent
|
|
|
|
|
|
|
|
├── [COMPOSE] Farm Agent (:8889)
|
|
|
|
├── [COMPOSE] Farm Agent (:8889)
|
|
|
|
|
|
|
|
├── [COMPOSE] Node-exporter (:9100) -- standalone with pid:host
|
|
|
|
|
|
|
|
├── [COMPOSE] Telegraf -- metrics collection to InfluxDB
|
|
|
|
├── [COMPOSE] Watchtower
|
|
|
|
├── [COMPOSE] Watchtower
|
|
|
|
├── [SWARM] Telegraf (global), Node-exporter (global)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
@@ -70,7 +70,7 @@ hf-pdocker-02 (Worker, 7.6GB RAM, i7-6700T, HDD)
|
|
|
|
|
|
|
|
|
|
|
|
You are working in a **WSL 2 environment** on Windows. Docker is NOT directly available in WSL - all Docker operations must be performed by connecting to the remote nodes via SSH.
|
|
|
|
You are working in a **WSL 2 environment** on Windows. Docker is NOT directly available in WSL - all Docker operations must be performed by connecting to the remote nodes via SSH.
|
|
|
|
|
|
|
|
|
|
|
|
**Critical:** Use the `docker-swarm-ops` agent (via Task tool) for ALL Docker operations. Do not attempt to run docker commands directly in bash - they will fail.
|
|
|
|
**Critical:** Docker is not available locally in WSL. All Docker operations must be performed by connecting to the remote nodes via SSH.
|
|
|
|
|
|
|
|
|
|
|
|
### Storage Architecture
|
|
|
|
### Storage Architecture
|
|
|
|
|
|
|
|
|
|
|
@@ -84,7 +84,7 @@ All service data lives on the **Synology NAS** via NFS, mounted at `/mnt/docker-
|
|
|
|
├── traefik/ # Let's Encrypt certs
|
|
|
|
├── traefik/ # Let's Encrypt certs
|
|
|
|
└── compose/ # Standalone compose files per node
|
|
|
|
└── compose/ # Standalone compose files per node
|
|
|
|
├── hf-pdocker-01/{frigate,frigate-notify,clip-service,matrix,smarthome,guacamole,ai-agents,traefik,adguard}/
|
|
|
|
├── hf-pdocker-01/{frigate,frigate-notify,clip-service,matrix,smarthome,guacamole,ai-agents,traefik,adguard}/
|
|
|
|
├── hf-pdocker-02/{unifi,gitea,semaphore,wikijs,vaultwarden,actual-budget,mcpo,trivy,netclaw,watchtower}/
|
|
|
|
├── hf-pdocker-02/{unifi,gitea,semaphore,wikijs,vaultwarden,actual-budget,mcpo,trivy,watchtower}/
|
|
|
|
└── bart/{media,openvas,watchtower}/
|
|
|
|
└── bart/{media,openvas,watchtower}/
|
|
|
|
```
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
@@ -95,13 +95,10 @@ All service data lives on the **Synology NAS** via NFS, mounted at `/mnt/docker-
|
|
|
|
### Repository File Structure
|
|
|
|
### Repository File Structure
|
|
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
```
|
|
|
|
stacks/ # Swarm stack definitions (deployed on hf-pdocker-01)
|
|
|
|
stacks/ # LEGACY Swarm stack definitions (Swarm dismantled 2026-04-01, kept for reference)
|
|
|
|
├── {service-name}/
|
|
|
|
|
|
|
|
│ ├── docker-compose.yml
|
|
|
|
|
|
|
|
│ └── .env (if needed)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
compose/ # Standalone Compose definitions (deployed per-node)
|
|
|
|
compose/ # Standalone Compose definitions (deployed per-node)
|
|
|
|
├── hf-pdocker-01/ # Frigate
|
|
|
|
├── hf-pdocker-01/ # Core infrastructure + Frigate
|
|
|
|
├── hf-pdocker-02/ # Dev tools & utilities
|
|
|
|
├── hf-pdocker-02/ # Dev tools & utilities
|
|
|
|
│ ├── {service}/docker-compose.yml
|
|
|
|
│ ├── {service}/docker-compose.yml
|
|
|
|
│ └── {service}/.env
|
|
|
|
│ └── {service}/.env
|
|
|
@@ -110,20 +107,15 @@ compose/ # Standalone Compose definitions (deployed per-node)
|
|
|
|
|
|
|
|
|
|
|
|
### Deployment Workflow
|
|
|
|
### Deployment Workflow
|
|
|
|
|
|
|
|
|
|
|
|
**Swarm services (stacks/):**
|
|
|
|
**All services (compose/):**
|
|
|
|
1. Edit stack file in `stacks/{service-name}/docker-compose.yml`
|
|
|
|
|
|
|
|
2. SCP to hf-pdocker-01 and redeploy: `docker stack deploy -c <file> <stack-name>`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**Standalone Compose services (compose/):**
|
|
|
|
|
|
|
|
1. Edit compose file in `compose/{node}/{service}/docker-compose.yml`
|
|
|
|
1. Edit compose file in `compose/{node}/{service}/docker-compose.yml`
|
|
|
|
2. SCP to NAS path or node, then: `cd /mnt/docker-data/compose/{node}/{service} && docker compose up -d`
|
|
|
|
2. SCP to NAS path or node, then: `cd /mnt/docker-data/compose/{node}/{service} && docker compose up -d`
|
|
|
|
|
|
|
|
|
|
|
|
### Service Architecture Patterns
|
|
|
|
### Service Architecture Patterns
|
|
|
|
|
|
|
|
|
|
|
|
**Network Patterns:**
|
|
|
|
**Network Patterns:**
|
|
|
|
- **Swarm services**: Overlay networks for inter-service communication
|
|
|
|
|
|
|
|
- **Compose services**: Bridge networks for service isolation
|
|
|
|
- **Compose services**: Bridge networks for service isolation
|
|
|
|
- **Public services** (Traefik): Connect to `traefik-public` overlay + Traefik labels
|
|
|
|
- **Public services** (Traefik): Traefik labels + dynamic config files in `/mnt/docker-data/traefik/dynamic/`
|
|
|
|
|
|
|
|
|
|
|
|
**Database Patterns:**
|
|
|
|
**Database Patterns:**
|
|
|
|
- PostgreSQL: `postgres:15-alpine` or `postgres:16-alpine`
|
|
|
|
- PostgreSQL: `postgres:15-alpine` or `postgres:16-alpine`
|
|
|
@@ -146,8 +138,8 @@ compose/ # Standalone Compose definitions (deployed per-node)
|
|
|
|
- Home Assistant: `yoda.hobbs.farm`
|
|
|
|
- Home Assistant: `yoda.hobbs.farm`
|
|
|
|
- Vaultwarden: `vault.hobbs.farm`
|
|
|
|
- Vaultwarden: `vault.hobbs.farm`
|
|
|
|
- Gitea: `git.hobbs.farm`
|
|
|
|
- Gitea: `git.hobbs.farm`
|
|
|
|
- Onyx: `onyx.hobbs.farm`
|
|
|
|
- VoiceCoach: `coach.hobbs.farm` (LiveKit WebRTC: `voice.hobbs.farm`)
|
|
|
|
- Open WebUI: `open.hobbs.farm`
|
|
|
|
- Rongorongo: `rongorongo.hobbs.farm`
|
|
|
|
|
|
|
|
|
|
|
|
### Internal Services by Node
|
|
|
|
### Internal Services by Node
|
|
|
|
|
|
|
|
|
|
|
@@ -155,7 +147,6 @@ compose/ # Standalone Compose definitions (deployed per-node)
|
|
|
|
- Frigate: :5000
|
|
|
|
- Frigate: :5000
|
|
|
|
- Frigate Alerts (v2): :5199 (web UI + REST API)
|
|
|
|
- Frigate Alerts (v2): :5199 (web UI + REST API)
|
|
|
|
- clip-service: :5200 (CLIP embeddings, ViT-L-14, CPU)
|
|
|
|
- clip-service: :5200 (CLIP embeddings, ViT-L-14, CPU)
|
|
|
|
- Open WebUI: :3010 (AI chat UI, public at open.hobbs.farm)
|
|
|
|
|
|
|
|
- Home Assistant: :8123
|
|
|
|
- Home Assistant: :8123
|
|
|
|
- ESPHome: :6052
|
|
|
|
- ESPHome: :6052
|
|
|
|
- Mosquitto: :1883
|
|
|
|
- Mosquitto: :1883
|
|
|
@@ -170,9 +161,11 @@ compose/ # Standalone Compose definitions (deployed per-node)
|
|
|
|
- InfluxDB: :8086
|
|
|
|
- InfluxDB: :8086
|
|
|
|
- Blackbox Exporter: :9115
|
|
|
|
- Blackbox Exporter: :9115
|
|
|
|
- matrix-alertmanager-receiver: :9094
|
|
|
|
- matrix-alertmanager-receiver: :9094
|
|
|
|
- AI Agents (margaret :18790, spirit :18795 [infra ops — monitors #notifications, auto-remediates alerts], clippy :18800, bob :18810, travis :18815) -- LAN-accessible (bind=lan, 0.0.0.0)
|
|
|
|
- AI Agents (margaret :18790, spirit :18795 [infra ops — monitors #notifications, auto-remediates alerts]) -- LAN-accessible (bind=lan, 0.0.0.0)
|
|
|
|
- Farm Manager: :8888 (dashboard + API)
|
|
|
|
- Farm Manager: :8888 (dashboard + API)
|
|
|
|
- Farm Agent: :8889
|
|
|
|
- Farm Agent: :8889
|
|
|
|
|
|
|
|
- Rongorongo: :8181 (web at rongorongo.hobbs.farm)
|
|
|
|
|
|
|
|
- ~~VoiceCoach~~ -- moved to GPU machine (192.168.86.150) 2026-04-04
|
|
|
|
|
|
|
|
|
|
|
|
**hf-pdocker-02 (192.168.86.100):**
|
|
|
|
**hf-pdocker-02 (192.168.86.100):**
|
|
|
|
- Farm Agent: :8889
|
|
|
|
- Farm Agent: :8889
|
|
|
@@ -184,9 +177,6 @@ compose/ # Standalone Compose definitions (deployed per-node)
|
|
|
|
- Actual Budget: :5006
|
|
|
|
- Actual Budget: :5006
|
|
|
|
- MCPO: :8001
|
|
|
|
- MCPO: :8001
|
|
|
|
- Trivy: :4954
|
|
|
|
- Trivy: :4954
|
|
|
|
- SearXNG: :8888 (meta-search, Onyx web search backend)
|
|
|
|
|
|
|
|
- Unstructured API: :8000 (document parsing for Onyx file ingestion)
|
|
|
|
|
|
|
|
- NetClaw/Aaron: :1179 (internal only)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**bart (192.168.86.167):**
|
|
|
|
**bart (192.168.86.167):**
|
|
|
|
- Farm Agent: :8889
|
|
|
|
- Farm Agent: :8889
|
|
|
@@ -197,19 +187,27 @@ compose/ # Standalone Compose definitions (deployed per-node)
|
|
|
|
- NZBHydra2: :5076
|
|
|
|
- NZBHydra2: :5076
|
|
|
|
- Jellyseerr: :5055
|
|
|
|
- Jellyseerr: :5055
|
|
|
|
- OpenVAS: :9392
|
|
|
|
- OpenVAS: :9392
|
|
|
|
- Onyx: :3005 (AI document search/RAG)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**GPU Machine (192.168.86.196, RTX 3090):**
|
|
|
|
**GPU Machine (192.168.86.150, RTX 3090, 15GB RAM):**
|
|
|
|
- Ollama: :11434 (vision LLM, llava:13b)
|
|
|
|
- Ollama: :11434 (llama3.1:8b for VoiceCoach LLM, qwen2.5:14b, others)
|
|
|
|
|
|
|
|
- [COMPOSE] VoiceCoach (all services co-located):
|
|
|
|
|
|
|
|
- voicecoach-livekit: :7880/:7881, UDP 50000-50100 (public at voice.hobbs.farm)
|
|
|
|
|
|
|
|
- voicecoach-speaches-gpu: :8000 (GPU Whisper STT + Kokoro TTS, CUDA float16)
|
|
|
|
|
|
|
|
- voicecoach-speechbrain: :8001 (emotion analysis)
|
|
|
|
|
|
|
|
- voicecoach-token-server: :8080 (token + settings API)
|
|
|
|
|
|
|
|
- voicecoach-pipecat: pipeline agent (LLM via local Ollama llama3.1:8b)
|
|
|
|
|
|
|
|
- voicecoach-web: :8085 (public at coach.hobbs.farm)
|
|
|
|
|
|
|
|
- voicecoach-openclaw: :3100 (idle, kept for future Claude API routing)
|
|
|
|
|
|
|
|
- Compose: ~/voicecoach-speaches/docker-compose.yml
|
|
|
|
|
|
|
|
|
|
|
|
### Port Conflict Notes
|
|
|
|
### Port Conflict Notes
|
|
|
|
|
|
|
|
|
|
|
|
Port conflicts already resolved:
|
|
|
|
Port conflicts already resolved:
|
|
|
|
- Port 8000: Now used by Unstructured API on hf-pdocker-02 (MCPO moved to 8001, Portainer moved elsewhere)
|
|
|
|
- Port 8000: Freed (MCPO moved to 8001, Portainer moved elsewhere)
|
|
|
|
- Port 3000: AdGuard Home (Gitea moved to 3003)
|
|
|
|
- Port 3000: AdGuard Home (Gitea moved to 3003)
|
|
|
|
- Port 3001: Grafana (Semaphore moved to 3004)
|
|
|
|
- Port 3001: Grafana (Semaphore moved to 3004)
|
|
|
|
- Port 5000: Frigate uses host networking (registry container stopped)
|
|
|
|
- Port 5000: Frigate uses host networking (registry container stopped)
|
|
|
|
- AI Agent ports re-spaced (2026-03-15): openclaw 2026.3.13 uses gateway+2 and gateway+3 for browser/chrome-relay. Agents now spaced 5 apart: margaret=18790, spirit=18795, clippy=18800, bob=18810, travis=18815
|
|
|
|
- AI Agent ports re-spaced (2026-03-15): openclaw 2026.3.13 uses gateway+2 and gateway+3 for browser/chrome-relay. Agents spaced 5 apart: margaret=18790, spirit=18795
|
|
|
|
|
|
|
|
|
|
|
|
## Critical Configuration Preservation
|
|
|
|
## Critical Configuration Preservation
|
|
|
|
|
|
|
|
|
|
|
@@ -235,20 +233,11 @@ Do NOT wait for the user to ask. Do NOT skip "because the change was small." Eve
|
|
|
|
|
|
|
|
|
|
|
|
## Common Operations
|
|
|
|
## Common Operations
|
|
|
|
|
|
|
|
|
|
|
|
### Deploy/Update a Swarm Service
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1. Edit `stacks/{service}/docker-compose.yml`
|
|
|
|
|
|
|
|
2. Use docker-swarm-ops agent to SCP and deploy:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
|
|
docker stack deploy -c <compose-file> <stack-name>
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Deploy/Update a Compose Service
|
|
|
|
### Deploy/Update a Compose Service
|
|
|
|
|
|
|
|
|
|
|
|
1. Edit `compose/{node}/{service}/docker-compose.yml`
|
|
|
|
1. Edit `compose/{node}/{service}/docker-compose.yml`
|
|
|
|
2. Use docker-swarm-ops agent to:
|
|
|
|
2. SSH to the target node and run:
|
|
|
|
```bash
|
|
|
|
```bash
|
|
|
|
# On the target node:
|
|
|
|
|
|
|
|
cd /mnt/docker-data/compose/{node}/{service}
|
|
|
|
cd /mnt/docker-data/compose/{node}/{service}
|
|
|
|
docker compose up -d
|
|
|
|
docker compose up -d
|
|
|
|
```
|
|
|
|
```
|
|
|
@@ -256,11 +245,7 @@ Do NOT wait for the user to ask. Do NOT skip "because the change was small." Eve
|
|
|
|
### Troubleshoot
|
|
|
|
### Troubleshoot
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
```bash
|
|
|
|
# Swarm services (on hf-pdocker-01):
|
|
|
|
# On target node:
|
|
|
|
docker service ls
|
|
|
|
|
|
|
|
docker service logs {stack}_{service} --tail 100
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Compose services (on target node):
|
|
|
|
|
|
|
|
docker compose -f /mnt/docker-data/compose/{node}/{service}/docker-compose.yml logs --tail 100
|
|
|
|
docker compose -f /mnt/docker-data/compose/{node}/{service}/docker-compose.yml logs --tail 100
|
|
|
|
docker ps --format "table {{.Names}}\t{{.Status}}"
|
|
|
|
docker ps --format "table {{.Names}}\t{{.Status}}"
|
|
|
|
```
|
|
|
|
```
|
|
|
@@ -268,13 +253,8 @@ docker ps --format "table {{.Names}}\t{{.Status}}"
|
|
|
|
### Check Cluster Health
|
|
|
|
### Check Cluster Health
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
```bash
|
|
|
|
# On hf-pdocker-01:
|
|
|
|
|
|
|
|
docker node ls # Swarm node status
|
|
|
|
|
|
|
|
docker service ls # Swarm services
|
|
|
|
|
|
|
|
docker stack ls # Deployed stacks
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# On each node:
|
|
|
|
# On each node:
|
|
|
|
docker ps # Local containers (Compose + Swarm)
|
|
|
|
docker ps # Local containers
|
|
|
|
```
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## Data Management
|
|
|
|
## Data Management
|
|
|
@@ -296,9 +276,6 @@ All persistent data on NAS at `/mnt/docker-data/`:
|
|
|
|
|
|
|
|
|
|
|
|
## Specialized Agents
|
|
|
|
## Specialized Agents
|
|
|
|
|
|
|
|
|
|
|
|
### docker-swarm-ops
|
|
|
|
|
|
|
|
**Use for:** All Docker operations (Swarm + Compose) on any node
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### vault-credential-manager
|
|
|
|
### vault-credential-manager
|
|
|
|
**Use for:** Storing/retrieving credentials from Vaultwarden
|
|
|
|
**Use for:** Storing/retrieving credentials from Vaultwarden
|
|
|
|
|
|
|
|
|
|
|
|