kitestacks-homelab/RUNBOOK.md

69 lines
1.5 KiB
Markdown

# KiteStacks Homelab Runbook
## Purpose
This repository documents the KiteStacks homelab.
## Documentation Standard
Each major repo or project should have RUNBOOK.md, CHANGELOG.md, and DEBUG-DOCUMENTATION.md.
## Main Host
Primary host: monk (LAN IP 192.168.1.205)
assassin (T14): retired/OFF, no longer part of production.
kscloud1 (Hetzner cloud, 5.78.233.28): permanent ACTIVE cloud failover - runs
a full replica of all 9 public services as a 3rd Cloudflare Tunnel connector,
load-balanced active-active alongside monk. See
docs/disaster-recovery/RUNBOOK.md for full details.
Main repo: ~/kitestacks-live (on monk)
## Public URLs
- https://www.kitestacks.com
- https://gitforge.kitestacks.com
- https://auth.kitestacks.com
## Discord Integration
Project docs live in projects/Discord Integration/.
Recent activity channel: #recent-activity
Webhook env file: /etc/kitestacks/discord-webhook.env
Activity script: /usr/local/bin/kitestacks-discord-activity.sh
Do not commit webhook URLs, tokens, secrets, database files, sessions, or live container data.
## Known Issue
The root CHANGELOG.md was generated by autosync and includes live app/database file changes.
## Karakeep Bookmarks
Karakeep replaced Shaarli as the bookmark/read-it-later service.
Public URL:
https://links.kitestacks.com
Cloudflare Tunnel service target:
http://karakeep:80
Docker path:
~/docker/karakeep
Containers:
- karakeep
- karakeep-meilisearch
- karakeep-chrome
Import path:
Settings → Import / Export → Import Bookmarks