oskar 8a1abd5750 feat(kb): SPLIT chelsty-runtime -> node + runbook

kb/nodes/chelsty-infra.md — runtime layout, SLZB-06U, ograniczenia sieciowe,
  lokalizacja configu Z2M, chelsty-ha bez node-agenta, backup sets
kb/runbooks/chelsty-deploy-recovery.md — Deployment Flow + Recovery Procedures

Tresc sekcji nietknieta; kontrola multizbioru linii == oryginal.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-04 16:58:46 +02:00

1.5 KiB

Raw Blame History

okf

type

visibility

status

updated

links

0.1

runbook

private

active

2026-05-27

../nodes/chelsty-infra.md

CHELSTY — deployment i procedury odtworzeniowe

Deployment Flow

Initial Bootstrap

./scripts/bootstrap/chelsty-runtime.sh

Deploy services

./scripts/deploy/deploy-node.sh chelsty-infra
./scripts/deploy/deploy-node.sh chelsty-ha

Manual (SSH) — chelsty-infra uses docker-compose v1

ssh oskar@100.122.201.22
cd ~/homelab-codex-ws/services/<service>
docker-compose -f docker-compose.yml \
  -f ../../hosts/chelsty-infra/runtime/<service>/docker-compose.override.yml \
  up -d --build --force-recreate

Note: docker compose (v2) is not available on chelsty-infra — always use docker-compose (hyphenated, v1 1.29.2).

Recovery Procedures

Mosquitto stopped

ssh oskar@100.122.201.22 "docker start mosquitto"
# Ensure restart policy is correct:
docker update --restart unless-stopped mosquitto

Zigbee2MQTT won't start

Check logs: docker logs zigbee2mqtt --tail 50
Verify SLZB-06U reachable from host: nc -zv 192.168.1.105 6638
Verify config is not empty: cat /opt/homelab/data/zigbee2mqtt/data/configuration.yaml
If config missing, recreate from the minimal template above

SLZB-06U unreachable

192.168.1.105:6638 EHOSTUNREACH means the coordinator is offline or the LAN is down. Zigbee2MQTT will keep retrying — no restart needed once the coordinator returns.

1.5 KiB Raw Blame History