Quadraplex-T-3000

An overly complicated homelab setup that also acts as documentation and templete for others (only reason it's public). It installs Docker, configures Traefik as a reverse proxy, and orchestrates application stacks including:

• Media services (Arr stack) – Radarr, Sonarr, Lidarr, etc.
• Monitoring tools – Prometheus, cAdvisor, Grafana, Uptime Kuma.
• Management utilities – Portainer, Vaultwarden, and helper services.

All services are grouped into stacks, making it easy to enable or disable specific apps and extend the setup with new deployments.

my-stack-ansible/
├── ansible.cfg # Ansible configuration
├── Makefile # Task shortcuts
├── README.md # Documentation
├── .gitignore # Ignore rules
│
├── inventory/ # Inventory definitions
│ ├── hosts.yml
│ ├── group_vars/ # Group-specific variables
│ └── host_vars/ # Host-specific variables
│
├── playbooks/ # Playbooks for different stacks/tasks
│ ├── site.yml
│ ├── deploy-media-stack.yml
│ ├── deploy-management-stack.yml
│ ├── update-stack.yml
│
├── roles/ # Modular Ansible roles
│ ├── docker/ # Docker installation/config
│ ├── traefik/ # Reverse proxy setup
│ ├── media-stack/ # Media apps (Arr stack)
│ ├── utility-stack/ # Monitoring/utility apps
│ ├── backup/ # Backup automation
│ └── secrets-management/ # Vaultwarden and secrets
│
├── secrets/ # Encrypted secrets & scripts
├── files/ # SSL certs, scripts, dashboards
├── templates/ # Systemd and Docker templates
└── vars/ # Shared variables (versions, networks)

• Ansible: Provisioning, configuration, deployment.
• Make: Task runner for common operations.
• Bash: Utility scripts for secrets, backups, and host operations.

1. System Prep

   • Installs prerequisites.
   • Configures Docker daemon and networking.

2. Reverse Proxy

   • Deploys Traefik for HTTPS and routing.
   • Manages TLS, middlewares, and service discovery.

3. Media Stack

   • Deploys Radarr, Sonarr, Lidarr, and related services.

4. Monitoring & Utilities

   • Prometheus & cAdvisor – metrics collection.
   • Grafana – dashboards and visualization.
   • Uptime Kuma – uptime monitoring.
   • Portainer – Docker management UI.

5. Secrets & Backup

   • Vaultwarden for secure storage.
   • Automated backup and restore playbooks.

• Control machine:
  • Ansible ≥ 2.13
  • Python ≥ 3.8
  • make installed
• Managed hosts:
  • Linux (tested on Debian/Ubuntu)
  • SSH access

• Edit inventory/hosts.yml and adjust group_vars/ and host_vars/ for your environment.

make help - Show help message with available commands. make install-docker - Install Docker on target environment (e.g., ENV=production). make install-docker-host - Install Docker on a specific host (e.g., HOST=media-prod-01). make install-docker-parallel - Install Docker on multiple hosts in parallel.

make docker-info - Show Docker system information. make docker-version - Show Docker and Docker Compose versions. make docker-test - Run a test container (hello-world) to verify installation. make docker-status - Check Docker service status. make docker-logs - View Docker service logs (last 50 lines). make docker-restart - Restart Docker service. make docker-cleanup - Remove unused Docker resources (system prune). make docker-disk-usage - Show Docker disk usage. make docker-validate - Validate Docker installation (runs playbook with validation tags).

make docker-daemon-reload - Reload Docker daemon configuration and restart service. make docker-users-check - Check which users belong to the Docker group.

make docker-debug - Run Docker installation playbook in debug mode (-vvv). make docker-remove - Remove Docker installation and all data (destructive).