Kavi Infrastructure¶
Welcome to the internal documentation for Kavi's server infrastructure.
Internal Only
This documentation is accessible only via Tailscale. Do not share access credentials.
🌐 Quick Access¶
Servers¶
| Server | Tailscale | Public IP | Purpose |
|---|---|---|---|
| Kimsufi | 100.81.231.36 |
144.217.76.53 |
Plex & Media |
| Production VPS | TBD | 116.203.109.220 |
Web Services (Prod) |
| Development VPS | TBD | 46.224.125.1 |
Testing & Development |
Services¶
| Service | URL | Server |
|---|---|---|
| Plex | plex.kua.cl | Kimsufi |
| Radarr | radarr.kua.cl | Kimsufi |
| Sonarr | sonarr.kua.cl | Kimsufi |
| Overseerr | overseerr.kua.cl | Kimsufi |
| Forgejo | git.kua.cl | Production |
| Catalog | dev.kua.cl | Production |
| Kuanary | Internal only (port 5001) | Production |
| Image CDN | cdn.kua.cl | Production |
| Infisical | secrets.kua.cl | Production |
| Portainer | Internal only (port 9000) | Production |
| Docs | docs.kua.cl | Production |
| Catalog Dev | dev.dev.kua.cl | Development |
📊 Infrastructure Overview¶
┌──────────────────────────────────────────────────────────────────────────┐
│ KAVI INFRASTRUCTURE │
├──────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
│ │ KIMSUFI │ │ PRODUCTION VPS │ │ DEVELOPMENT VPS │ │
│ │ (Canada) │ │ (Germany) │ │ (Germany) │ │
│ │ 144.217.76.53 │ │ 116.203.109.220 │ │ 46.224.125.1 │ │
│ │ │ │ │ │ │ │
│ │ • Plex │ │ • Forgejo │ │ • Catalog Dev │ │
│ │ • Radarr │ │ • Catalog Prod │ │ • Fast Rebuilds │ │
│ │ • Sonarr │ │ • Kuanary │ │ • Traefik │ │
│ │ • Overseerr │ │ • Infisical │ │ • Docker │ │
│ │ • qBittorrent │ │ • Portainer │ │ │ │
│ │ • SABnzbd │ │ • Traefik │ │ │ │
│ └────────┬───────┘ └────────┬─────────┘ └─────────┬────────┘ │
│ │ │ │ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌────────────────┐ ┌──────────────────────────────────────────┐ │
│ │ Local Disk │ │ Hetzner Storage Box (SFTP) │ │
│ │ 8TB HDD │ │ /mnt/storagebox/ (via rclone) │ │
│ │ (No RAID) │ │ │ │
│ └────────────────┘ │ • Git repositories (kuatecno/) │ │
│ │ • Backups │ │
│ │ • Shared data │ │
│ └──────────────────────────────────────────┘ │
│ ▲ │
│ │ │
│ ┌─────────────┴────────────┐ │
│ │ Hetzner Object Storage │ │
│ │ (S3 - fsn1) │ │
│ │ • Image uploads (kua) │ │
│ └──────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────────────────────┘
🔧 Quick Commands¶
SSH Access¶
# Kimsufi (Media Server)
ssh ubuntu@100.81.231.36
# Production VPS (Web Services)
ssh kavi@116.203.109.220
# or via SSH config alias:
ssh production
# Development VPS (Testing)
ssh kavi@46.224.125.1
# or via SSH config alias:
ssh development
# Storage Box (Hetzner)
ssh -p 23 u522581@u522581.your-storagebox.de
Docker¶
# Kimsufi - view containers
ssh ubuntu@100.81.231.36 "docker ps"
# Production - view containers
ssh production "docker ps"
# Development - view containers
ssh development "docker ps"
Common Operations¶
# Check Storage Box mount (Production)
ssh production "ls -la /mnt/storagebox/"
# View deployment logs (Development)
ssh development "tail -f /var/log/deployments.log"
# Restart a service (Production)
ssh production "cd /opt/catalog && docker-compose restart"
# Check Traefik routes (Production)
ssh production "docker logs traefik --tail 50"
📁 Documentation Sections¶
- Ecosystem Overview - Full system architecture
- Kimsufi Server - Plex and media services
- Hetzner VPS - Web services and APIs
- Kuanary API - Image CDN API documentation
- Storage - S3, Storage Box, backups
- Runbooks - How-to guides and troubleshooting
🚀 Recent Updates¶
- 2026-01-03: Added Kuanary API documentation with SSL
- 2026-01-03: Implemented Storage-First development workflow
- 2026-01-03: Configured development VPS with auto-deploy webhooks
- 2025-12: Initial documentation structure created
Last updated: January 2026