Skip to content

A comprehensive homelab environment running Proxmox VE with a focus on media automation and self-hosted services. Features a complete media management stack, development tools, and secure remote access via Tailscale, all managed with Docker containers and LXC virtualization.

License

Notifications You must be signed in to change notification settings

Gauransh-Homelab/Homelab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Homlab V2

You can see current progress with this link below

https://publish.obsidian.md/gauranshmathur

v2 Is currently in progress, currently using a talos cluster and migrating all services, the README will be updated once full migration is complete with details on the migration, what services used etc. v1 README will still be available for reference

🏠 Homelab v1 Setup

Homelab Status Proxmox Services Last Updated

A personal homelab environment with virtualization, media services, and remote access

HardwareNetworkServicesFuture Plans


🔍 Quick Overview

What: Home server setup for media, development, and learning
Why: Self-host services with full control and customization
How: Proxmox VE + Docker + LXC Containers


💻 Hardware

Component Details
Main Server
Acer XC-780
• Intel i5-7400
• 16GB DDR4 RAM
• NVIDIA GT-730
Storage
Synology DS423+
• 2x 12TB drives in SHR
• 1-drive fault tolerance
• Dual Ethernet connectivity

🌐 Network

graph TD
    Internet((Internet)) --> Router
    Router --> Switch[TP-Link 8-Port Switch]
    Switch --> Server[Acer XC-780]
    Switch --> NAS[Synology DS423+]
    Switch --> OtherDevices[Other Devices]
    
    class Server,NAS emphasis
Loading

Switch: TP-Link 8-Port Unmanaged Gigabit Switch
Connectivity: All Ethernet (1Gbps)
NAS Feature: Link aggregation with dual Ethernet ports


🧩 Software Architecture

Layer Component Purpose
Base Proxmox VE Hypervisor for VMs & LXC management
Tailscale Secure remote access (exit node)
Network Nginx Proxy Manager Reverse proxy for service access
DuckDNS Dynamic DNS for domain management

🚀 Services

Development Tools

  • ⌨️ Wastebin - Code snippet sharing (LXC container)

Media Stack

Icon Service Type Function Container
Jellyfin 📺 Media Streaming server Docker
qBittorrent ⬇️ Downloader Torrent client Docker
Sonarr 📺 Manager TV Shows Docker
Radarr 🎬 Manager Movies Docker
Prowlarr 🔍 Indexer Content search Docker
Bazarr 💬 Subtitles Subtitle management Docker
NZBGet ⬇️ Downloader Usenet client Docker
Gluetun 🔒 VPN ExpressVPN binding Docker
Jellyseerr 🔍 Frontend Media requests Docker
Notifiarr 🔔 Notifications Discord alerts Docker

DNS

  • 🛜 PI Hole - Adblocking and DNS Sinkhole (running on nas) [ attached directly to router ]

💡 Note: All media services managed via Portainer in a dedicated LXC container

⚠️ Current Issue: Tdarr disabled due to GPU compatibility with Intel Arc A310

Quality Setup

Sonarr and Radarr follow TRaSH guides for optimal quality profiles.


🗄️ Storage Architecture

Synology DS423+ (24TB Raw / ~10.9TB Usable) 1 drive fault tolerance
├── NAS
│   ├── Movies
│   ├── Shows
│   ├── Music
│   ├── Youtube
│   └── Downloads
│       └── Qbittorrent
│           ├── Torrents
│           ├── Completed
│           └── Incomplete
│       └── Nzbget
│           ├── Queue
│           ├── Nzb
│           ├── Intermediate
│           ├── Tmp
│           └── Completed
│
├── TimeMachine ( Macbook Backups )
│
└── Docker
    └── Pihole

🔮 Future Plans

Current vs Future Architecture

Component Current Planned
Virtualization Proxmox VE Talos Linux + K8s
Container Mgmt Docker/Portainer Kubernetes
Cloud Integration None Digital Ocean K8s
GPU Access Disabled Direct K8s passthrough
Storage Direct mount iSCSI for K8s

Migration Path

  1. Set up Digital Ocean Kubernetes cluster
  2. Migrate Docker containers to cloud K8s
  3. Replace Proxmox with Talos Linux locally
  4. Configure GPU passthrough
  5. Implement iSCSI storage

🚧 TODO: Create detailed migration plan document with timeline


🤝 Contributing

This is a personal project, but suggestions welcome via issues!

📜 License

MIT License

About

A comprehensive homelab environment running Proxmox VE with a focus on media automation and self-hosted services. Features a complete media management stack, development tools, and secure remote access via Tailscale, all managed with Docker containers and LXC virtualization.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages