junaydirfan/ultimate-selfhosted-homelab

This repository is a step-by-step setup guide for running a home server using a platform called Proxmox. Proxmox is a server operating system that lets you run multiple isolated environments on one physical machine. The guide covers the full path from installing Proxmox on bare hardware to having a working collection of self-hosted services, and is written so that someone else can replicate the setup or adapt it for different hardware. The architecture uses two main containers alongside the host. One runs Docker, a system for packaging and running applications in isolated units, and hosts about 30 services organized into groups. These include Immich for photo management, Karakeep for saving bookmarks, Navidrome for streaming music, Paperless-NGX for organizing scanned documents, AFFiNE for notes, and RoMM for managing game ROM files. A second container runs a web server, machine learning models, and a development environment. Standalone containers handle network infrastructure: Pi-hole for ad blocking, Tailscale for remote access over a private network, Cloudflare tunnels for external access, and Vaultwarden for storing passwords. The guide explains concepts as it goes. The section on lightweight containers describes what they are, how they differ from full virtual machines, and when to choose one over the other. The networking section covers internal DNS, external access, and ad blocking over VPN. Each step includes configuration tables, exact commands, and file paths. Recommended minimum hardware is four CPU cores, 16 gigabytes of RAM, and at least 1 terabyte of storage for media. The guide assumes a standard x86 machine and notes where steps would need adjustment for different setups.