2.7 KiB
Getting Started Guide
Welcome to your AI-powered homelab! This guide will walk you through setting up your production-ready infrastructure with Dockge, Traefik, Authelia, and 50+ services.
Release v0.1.0 Highlights
This is the first official release of EZ-Homelab, thoroughly tested on Debian 12. Key features include:
- Automated SSL via DuckDNS and Let's Encrypt.
- Authelia SSO enabled by default for security.
- Sablier lazy loading to save resources.
- 50+ preconfigured services across 10 stacks.
- See Release Notes for full details.
Getting Started Checklist
- Clone this repository to your home folder
- Configure
.envfile with your domain and tokens (see prerequisites) - Forward ports 80 and 443 from your router to your server
- Run unified setup script (generates Authelia secrets and admin user, deploys services) (ez-homelab.sh)
- Access Dockge web UI (
https://dockge.${DOMAIN}) - Set up 2FA with Authelia (Authelia setup guide)
- (optional) Deploy additional stacks as needed via Dockge (services overview)
- Configure and use VS Code with Github Copilot to manage the server (AI management | Example prompts)
Setup Options
Choose the setup method that works best for you:
🚀 Automated Setup (Recommended)
For most users, the automated scripts handle everything. See Automated Setup Guide for step-by-step instructions.
🔧 Manual Setup
If you prefer manual control or the automated script fails, see the Manual Setup Guide for detailed instructions.
🤖 AI-Assisted Setup
Learn how to use VS Code with GitHub Copilot for AI-powered homelab management. See AI VS Code Setup.
How It All Works
Before diving in, understand how your homelab infrastructure works together. See How Your AI Homelab Works for a comprehensive overview.
SSL Certificates
Your homelab uses Let's Encrypt for automatic HTTPS certificates. See SSL Certificates Guide for details on certificate management and troubleshooting.
What Comes Next
After setup, learn what to do with your running homelab. See Post-Setup Guide for accessing services, customization, and maintenance.
On-Demand Remote Services
For advanced users: Learn how to set up lazy-loading services on remote servers (like Raspberry Pi) that start automatically when accessed. See On-Demand Remote Services.