Home

🏠 Homelab¶

Unified • Automated • Production-Ready

Quick Start

Get up and running in minutes with our step-by-step guide
Service Management

Learn how to manage and configure your self-hosted services
Architecture

Understand the unified system architecture
Roadmap

See what's coming next in our development roadmap

What is Homelab?¶

A Docker Swarm-based homelab platform that simplifies running multiple self-hosted services. With pre-configured compose files for 28+ popular services, automatic SSL certificates via Traefik, centralized SSO via Authentik, and automated backups, you can have a complete production-ready homelab infrastructure running in minutes.

What is self-hosting?

Self-hosting is the practice of running and maintaining your own services instead of relying on third-party providers, giving you control over your data and infrastructure.

✨ Key Features¶

28+ Pre-Configured Services

Ready-to-deploy stacks for media, finance, AI, and more. Browse the Catalog →
Automatic SSL & Proxy

Traefik reverse proxy with Let's Encrypt + Cloudflare DNS automation.
Centralized SSO

Identity management and single sign-on via Authentik integrated with 10+ apps.
Hybrid Storage

iSCSI for databases and CIFS/SMB for media, ensuring performance and stability.
Production Ready

Docker Swarm orchestration with health checks and rolling updates.
One-Command Deploy

Deploy your entire stack with task ansible:deploy after a simple setup.

🏗️ Architecture Overview¶

graph TB subgraph "User & Configuration" USER("User") TASK("Taskfile.yml") DOT_ENV(".env") INVENTORY("ansible/inventory/02-hosts.yml") STACKS_DIR("stacks/") end subgraph "Orchestration" ANSIBLE("Ansible Playbooks") end subgraph "Docker Swarm Cluster" MANAGER("Manager Node") WORKER("Worker Node") TRAEFIK("Traefik Proxy") APPS("Apps") end USER -- "runs" --> TASK TASK -- "triggers" --> ANSIBLE ANSIBLE -- "reads" --> DOT_ENV ANSIBLE -- "reads" --> INVENTORY ANSIBLE -- "reads" --> STACKS_DIR ANSIBLE -- "deploys to" --> MANAGER MANAGER -- "manages" --> WORKER MANAGER -- "runs" --> TRAEFIK MANAGER -- "runs" --> APPS

🚀 Getting Started¶

Ready to start your self-hosting journey? Choose your path:

:material-timer-fast: Quick Start →

Get up and running on a single machine in 5 minutes.
Full Installation Guide →

Complete multi-node setup with network storage and SSO.
Services Catalog →

Explore all 28+ pre-configured application stacks.

🏷️ Tags¶

Browse by tags to find content relevant to your use case.