# 📋 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