kitestacks-homelab/RUNBOOK.md

1.5 KiB

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

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