Ai, Automation, Kubernetes, Docker Cloud Server
kenpat
f38decc285
- apps/forgejo/docker-compose.yml: enable FORGEJO__actions__ENABLED=true
- apps/forgejo-runner/docker-compose.yml: forgejo-runner:3.5.0 container
mounts docker.sock so jobs can spin up containers on monk
- .forgejo/workflows/ci.yml: 3-job pipeline on every push to main
compose-lint → validates all apps/*/docker-compose.yml
secrets-check → scans for hardcoded passwords/tokens/keys
shellcheck → lints all scripts/*.sh
- docs/ci-cd-setup.md: runner registration steps + extension guide
PENDING (needs user action):
1. docker compose up -d --force-recreate in apps/forgejo/ to apply env
2. Get runner token from Forgejo admin panel
3. Run forgejo-runner register with token, then docker compose up
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
||
|---|---|---|
| .forgejo/workflows | ||
| apps | ||
| autosync | ||
| cloud | ||
| cloud-migration | ||
| clusters/T14s | ||
| docs | ||
| homelab-mastery | ||
| osticket | ||
| projects/Discord Integration | ||
| scripts | ||
| .gitignore | ||
| CHANGELOG.md | ||
| DEBUG-DOCUMENTATION.md | ||
| README.md | ||
| RUNBOOK.md | ||
KiteStacks Homelab
Everything needed to run, fix, and understand the KiteStacks homelab lives here.
What is KiteStacks?
KiteStacks is a personal homelab — a set of useful web apps that run on two computers (monk at home, kscloud1 in Germany). All the websites are accessible over the internet through Cloudflare without exposing any home IP addresses.
How to Read This Repo
| File / Folder | What it is |
|---|---|
RUNBOOK.md |
Start here. Plain-English guide to how everything works and how to do common tasks |
DEBUG-DOCUMENTATION.md |
Every problem we've hit and how we solved it |
docs/ |
Detailed setup guides for specific services (Authentik SSO, etc.) |
apps/ |
Docker Compose files for each service |
clusters/ |
Infrastructure-level configs |
projects/ |
Active project notes |
cloud/ |
Cloud-specific configurations (kscloud1) |
cloud-migration/ |
Archive of cloud migration work and volume backups |
autosync/ |
Auto-sync scripts that keep the repo up to date automatically |
osticket/ |
OSTicket help-desk project notes |
Services Running Right Now
| Service | Website | What it does |
|---|---|---|
| Authentik | auth.kitestacks.com | Single login for all services |
| Portainer | portainer.kitestacks.com | Manage all Docker containers |
| Forgejo | gitforge.kitestacks.com | Git server (code + scripts) |
| BookStack | wiki.kitestacks.com | Wiki and notes |
| Grafana | grafana.kitestacks.com | Server health charts |
| Karakeep | links.kitestacks.com | Bookmark manager |
| Kavita | kavita.kitestacks.com | Ebook reader |
| OSTicket | tasks.kitestacks.com | Help desk / ticket system |
| Open WebUI | ai.kitestacks.com | AI chat (GPT, Claude, local) |
| Uptime Kuma | status.kitestacks.com | Service monitor |
| Portal | www.kitestacks.com | Homepage |
Quick Reference
# Check all running containers
docker ps --format "table {{.Names}}\t{{.Status}}"
# Restart a service
cd ~/kitestacks-live/docker/SERVICE_NAME && docker compose restart
# View live logs
docker logs CONTAINER_NAME --tail 50 -f
All usernames and passwords go through Authentik at https://auth.kitestacks.com.