# 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