{"id":20419687,"url":"https://github.com/saiteja-madha/docker-homelab","last_synced_at":"2025-08-21T19:11:34.123Z","repository":{"id":257973478,"uuid":"869071706","full_name":"saiteja-madha/docker-homelab","owner":"saiteja-madha","description":"A collection of Docker Compose configurations for managing my homelab environment with Traefik and Portainer.","archived":false,"fork":false,"pushed_at":"2025-01-22T06:02:51.000Z","size":46,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-24T20:40:24.521Z","etag":null,"topics":["docker-homelab","traefik-docker"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/saiteja-madha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-07T17:07:29.000Z","updated_at":"2025-01-22T06:02:54.000Z","dependencies_parsed_at":"2025-01-01T20:29:29.648Z","dependency_job_id":"99312650-35e4-4c27-ad30-6e7ea74f0270","html_url":"https://github.com/saiteja-madha/docker-homelab","commit_stats":null,"previous_names":["saiteja-madha/docker-homelab"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saiteja-madha%2Fdocker-homelab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saiteja-madha%2Fdocker-homelab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saiteja-madha%2Fdocker-homelab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saiteja-madha%2Fdocker-homelab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saiteja-madha","download_url":"https://codeload.github.com/saiteja-madha/docker-homelab/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241961689,"owners_count":20049516,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker-homelab","traefik-docker"],"created_at":"2024-11-15T06:38:02.741Z","updated_at":"2025-08-21T19:11:34.095Z","avatar_url":"https://github.com/saiteja-madha.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker Homelab\n\nMy personal Docker Compose-based homelab environment with reverse proxy, dashboard, monitoring, media services, analytics, and more.\n\n## 🚀 Overview\n\nThis repository contains a modular Docker Compose setup to create a complete homelab environment. The architecture uses Traefik as the backbone for routing traffic to various services, all manageable through Portainer's intuitive UI.\n\n### 🛠️ Core Components\n\n- **Reverse Proxy**\n  - **Traefik**: Modern HTTP reverse proxy and load balancer with automatic SSL\n- **Dashboard**\n\n  - **Portainer**: Web-based Docker management UI\n\n- **Monitoring Stack**\n\n  - **Prometheus**: Metrics collection and storage\n  - **Grafana**: Metrics visualization and dashboarding\n  - **Node Exporter**: System metrics collection\n  - **cAdvisor**: Container resource usage metrics\n\n- **Media Services**\n\n  - **Lavalink**: Audio player API for Discord bots\n\n- **Analytics**\n\n  - **Umami**: Privacy-focused website analytics\n\n- **Development Tools**\n\n  - **Code Server**: VS Code in the browser\n\n- **Project Environments**\n  - **Discord JS Bot**: Discord bot environment\n  - **Strange API**: API service\n  - **Flowbite Admin Dashboard**: Web dashboard\n\n## 📋 Prerequisites\n\n- Docker (recent version)\n- Docker Compose v2\n- A domain name (for SSL and service access)\n\n## ⚙️ Setup\n\n1. **Clone the Repository**\n\n```sh\ngit clone https://github.com/saiteja-madha/docker-homelab.git\ncd docker-homelab\n```\n\n2. **Set Up Environment Variables**\n\n```sh\ncp .env.example .env\n```\n\nEdit the `.env` file with your configuration:\n\n- Set your domain name (`DOMAIN`)\n- Configure email for Let's Encrypt (`EMAIL`)\n- Set up authentication credentials (`BASIC_AUTH_USERS`)\n- Configure service-specific variables\n\n3. **Create a Docker Network**\n\n```sh\ndocker network create proxy\n```\n\n4. **Deploy the Stack**\n\nDeploy all services:\n\n```sh\ndocker compose up -d\n```\n\nOr deploy specific services:\n\n```sh\ndocker compose up -d traefik portainer\n```\n\n## 🔧 Maintenance\n\n### Updating Services\n\nTo update a specific service:\n\n```sh\ndocker compose pull [service]\ndocker compose up -d [service]\n```\n\nTo update all services:\n\n```sh\ndocker compose pull\ndocker compose up -d\n```\n\n### Viewing Logs\n\n```sh\ndocker compose logs -f [service]\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Feel free to submit issues and pull requests to improve this setup.\n\n## 📄 License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaiteja-madha%2Fdocker-homelab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaiteja-madha%2Fdocker-homelab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaiteja-madha%2Fdocker-homelab/lists"}