https://github.com/meanii/homelab
💫 meanii's home network stacks
https://github.com/meanii/homelab
docker-compose home-lab kubernetes manifest
Last synced: about 2 months ago
JSON representation
💫 meanii's home network stacks
- Host: GitHub
- URL: https://github.com/meanii/homelab
- Owner: meanii
- Created: 2022-09-17T02:54:26.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-10-26T08:16:59.000Z (8 months ago)
- Last Synced: 2026-04-29T06:38:46.513Z (about 2 months ago)
- Topics: docker-compose, home-lab, kubernetes, manifest
- Language: Shell
- Homepage:
- Size: 342 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Homelab Stacks
> My personal homelab stack: self-hosted services, automation, and reverse proxy setup – all running on Proxmox. 🦉
---
## Table of Contents
- [About](#about)
- [Getting Started](#getting_started)
- [Running Services](#running_services)
- [Architecture](#architecture)
- [TODO](#todo)
---
This repository contains a collection of services I run on my homelab, now hosted on **Proxmox**. The setup uses:
- **Proxmox** for VM/container orchestration.
- A **VPS** as a public-facing FRP tunnel server.
- **Nginx Proxy Manager** as a centralized reverse proxy.
- **frp (Fast Reverse Proxy)** for secure tunneling behind NAT.
- **Docker** for managing all services.
Public access is routed through the VPS using **frps**, tunneled to my local network with **frpc**, and managed through **Nginx Proxy Manager**, giving me full control over HTTPS, access rules, and subdomain routing.
---
### Prerequisites
- Proxmox host with Docker installed (or LXC with Docker)
- Public VPS (used for tunnel server)
- Domain name (e.g., `example.com`)
---
### Reverse Proxy & Secure Tunnel
- [`nginxproxymanager`](proxmox/nginxproxymanager)
Centralized reverse proxy UI + `frpc` tunnel client.
- `frps` (runs on VPS)
Reverse tunnel server that bridges internet requests to local services.
### Media Stack
- [`media`](proxmox/media)
- **Jellyfin** – Media streaming
- **qBittorrent** + **qBittorrentBot** – Torrent downloads + Telegram control
- **Radarr**, **Sonarr**, **Prowlarr** – Media automation
- **Jellyseerr** – Discovery and request frontend
---
```text
┌──────────────────────────────┐
│ Public Internet │
└──────────────┬───────────────┘
│
[DNS: *.example.com]
│
┌──────────────▼──────────────┐
│ frps (VPS) │
│ [Reverse Tunnel] │
└──────────────┬──────────────┘
│
┌──────────────▼──────────────┐
│ frpc (Proxmox) │
│ [Tunnel Client] │
└──────────────┬──────────────┘
│
┌──────────────▼──────────────┐
│ Nginx Proxy Manager (NPM) │
│ [Reverse Proxy] │
└──────────────┬──────────────┘
│
┌───────────────┬────────┴────────┬────────────────┐
▼ ▼ ▼ ▼
[Media] [Notes/Docs] [Utilities] [Monitoring]
Jellyfin Memos Pi-hole Uptime-Kuma
qBit/Radarr Glance sshm Glance
````
---
* [ ] Add backup automation playbooks
* [ ] Expand Kubernetes service deployments
* [ ] Add documentation for Glance and Memos setup
* [ ] Setup Grafana + Prometheus for resource monitoring
---
## Homelab Snapshot
---
## Repository Layout
```
homelab/
├── docker/ # Docker services
│ └── pi-hole/ # Encrypted DNS + Pi-hole
├── proxmox/ # Main stack now runs here
│ ├── nginxproxymanager/ # Reverse proxy + frp
│ └── media/ # Jellyfin, qBit, Radarr, etc.
├── kubernetes/ # K8s manifests
│ └── uptime-kube/
├── services/ # Custom systemd services
│ └── sshm/
├── playbooks/ # Ansible automation
├── assets/ # Diagrams & images
└── readme.md
```