Sanitized mirror from private repository - 2026-04-19 08:15:48 UTC

services/categories.md

@@ -0,0 +1,236 @@
+# 📋 Service Categories
+
+*Organized categorization of all homelab services by function and purpose*
+
+## Overview
+This document provides a comprehensive categorization of all services running in the homelab infrastructure, organized by their primary function and purpose.
+
+## Media & Entertainment
+
+### Streaming Services
+- **Plex Media Server** - Primary media streaming platform
+- **Jellyfin** - Open-source media streaming alternative
+- **Navidrome** - Music streaming server
+- **Invidious** - Privacy-focused YouTube frontend
+- **Piped** - Alternative YouTube frontend
+
+### Media Management
+- **Sonarr** - TV series management and automation
+- **Radarr** - Movie management and automation
+- **Lidarr** - Music collection management
+- **Readarr** - Book and audiobook management
+- **Prowlarr** - Indexer management for *arr suite
+- **Bazarr** - Subtitle management
+
+### Media Tools
+- **Calibre** - E-book library management
+- **AudioBookShelf** - Audiobook and podcast server
+- **Tdarr** - Media transcoding and optimization
+- **YouTube-DL** - Video downloading service
+
+## Productivity & Office
+
+### Document Management
+- **Paperless-ngx** - Document management system
+- **Stirling PDF** - PDF manipulation tools
+- **DokuWiki** - Wiki and knowledge base
+- **Outline** - Team wiki and documentation
+
+### Communication
+- **Matrix Synapse** - Decentralized chat server
+- **Element** - Matrix client interface
+- **Mattermost** - Team collaboration platform
+- **Mastodon** - Decentralized social networking
+- **Signal API** - Signal messaging integration
+
+### File Management
+- **Nextcloud** - Cloud storage and collaboration
+- **Syncthing** - File synchronization
+- **Seafile** - File hosting and collaboration
+- **FileBrowser** - Web-based file manager
+
+## Development & DevOps
+
+### Version Control
+- **Gitea** - Git repository hosting
+- **Gitea Runner** - CI/CD automation
+- **GitLab** - Alternative Git platform (archived)
+
+### Development Tools
+- **OpenHands** - AI-powered development assistant
+- **Code Server** - VS Code in the browser
+- **Jupyter** - Interactive computing notebooks
+- **Draw.io** - Diagram and flowchart creation
+
+### Container Management
+- **Portainer** - Docker container management
+- **Watchtower** - Automated container updates
+- **Dozzle** - Docker log viewer
+
+## Infrastructure & Networking
+
+### Network Services
+- **Pi-hole** - Network-wide ad blocking
+- **AdGuard Home** - DNS filtering and protection
+- **Nginx Proxy Manager** - Reverse proxy management
+- **Cloudflare Tunnel** - Secure external access
+
+### VPN & Remote Access
+- **WireGuard** - VPN server
+- **Tailscale** - Mesh VPN networking
+- **Headscale** - Self-hosted Tailscale coordination server
+- **RustDesk** - Remote desktop access
+
+### DNS & DHCP
+- **Unbound** - Recursive DNS resolver
+- **Bind9** - Authoritative DNS server
+- **ISC DHCP** - DHCP server
+
+## Monitoring & Observability
+
+### Metrics & Monitoring
+- **Prometheus** - Metrics collection and storage
+- **Grafana** - Metrics visualization and dashboards
+- **AlertManager** - Alert routing and management
+- **Node Exporter** - System metrics collection
+
+### Logging
+- **Loki** - Log aggregation system
+- **Promtail** - Log shipping agent
+- **Fluentd** - Log collection and forwarding
+
+### Uptime & Health
+- **Uptime Kuma** - Service uptime monitoring
+- **Healthchecks.io** - Cron job monitoring
+- **StatusPage** - Public status page
+
+### Network Monitoring
+- **LibreNMS** - Network monitoring system
+- **PRTG** - Network monitoring (Windows)
+- **Zabbix** - Infrastructure monitoring
+
+## Security & Authentication
+
+### Identity Management
+- **Authentik** - Identity provider and SSO
+- **Keycloak** - Identity and access management
+- **LDAP** - Directory services
+
+### Security Tools
+- **Vaultwarden** - Password manager (Bitwarden)
+- **Fail2ban** - Intrusion prevention
+- **ClamAV** - Antivirus scanning
+- **OSSEC** - Host-based intrusion detection
+
+### Certificate Management
+- **Let's Encrypt** - SSL certificate automation
+- **Cert-Manager** - Kubernetes certificate management
+- **Step-CA** - Private certificate authority
+
+## Home Automation & IoT
+
+### Home Automation Platforms
+- **Home Assistant** - Comprehensive home automation
+- **OpenHAB** - Open-source automation platform
+- **Node-RED** - Flow-based automation
+
+### IoT Protocols
+- **Zigbee2MQTT** - Zigbee device integration
+- **Z-Wave JS** - Z-Wave device control
+- **ESPHome** - ESP device firmware
+
+### Environmental Monitoring
+- **InfluxDB** - Time-series database for sensor data
+- **Telegraf** - Metrics collection agent
+- **Sensor monitoring** - Temperature, humidity, air quality
+
+## Gaming & Entertainment
+
+### Game Servers
+- **Minecraft** - Minecraft server hosting
+- **Satisfactory** - Satisfactory dedicated server
+- **Left 4 Dead 2** - L4D2 game server
+- **Garry's Mod** - GMod PropHunt server
+- **PufferPanel** - Game server management
+
+### Gaming Tools
+- **Steam Cache** - Steam content caching
+- **Pterodactyl** - Game server management panel
+- **GameDig** - Game server query library
+
+## Backup & Storage
+
+### Backup Solutions
+- **Duplicati** - Encrypted backup solution
+- **Restic** - Fast, secure backup program
+- **Borg Backup** - Deduplicating backup program
+- **Rclone** - Cloud storage synchronization
+
+### Storage Management
+- **MinIO** - S3-compatible object storage
+- **TrueNAS** - Network attached storage
+- **Synology DSM** - NAS management interface
+
+## Utilities & Tools
+
+### System Utilities
+- **Glances** - System monitoring
+- **Netdata** - Real-time system monitoring
+- **htop** - Interactive process viewer
+- **iperf3** - Network performance testing
+
+### Web Tools
+- **IT Tools** - Collection of useful web tools
+- **Cyberchef** - Data manipulation toolkit
+- **Excalidraw** - Collaborative whiteboarding
+- **Shlink** - URL shortener
+
+### Notification Services
+- **NTFY** - Push notification service
+- **Gotify** - Self-hosted notification server
+- **Apprise** - Notification library
+
+## Archive & Deprecated
+
+### Archived Services
+- **Joplin** - Note-taking application (archived)
+- **Reactive Resume** - Resume builder (archived)
+- **Dokuwiki** - Wiki platform (replaced)
+- **Nginx** - Web server (replaced by NPM)
+
+### Legacy Systems
+- **Old monitoring stacks** - Deprecated monitoring solutions
+- **Legacy media tools** - Replaced media management tools
+- **Outdated networking** - Old network configurations
+
+---
+
+## Service Distribution by Host
+
+### Atlantis (Primary NAS)
+- Media streaming and management
+- File storage and backup
+- Core infrastructure services
+
+### Calypso (Secondary NAS)
+- Development and testing
+- Backup services
+- Secondary media processing
+
+### homelab_vm (Main VM)
+- Communication services
+- Monitoring and alerting
+- Development tools
+
+### concord_nuc (Intel NUC)
+- Home automation
+- IoT services
+- Edge computing
+
+### raspberry-pi-5-vish (Pi Systems)
+- Network services
+- Monitoring agents
+- Lightweight applications
+
+---
+**Status**: ✅ All service categories documented with current deployment status