Introduction

#

My Homelab Project

Welcome to the documentation for my personal homelab project. This repository contains a collection of guides, configuration files, and schematics that detail the setup and configuration of my homelab environment.

The primary goal of this project is to create a robust and flexible homelab environment for learning, experimentation, and self-hosting various services.

##

Architecture Overview

The following diagram illustrates the overall architecture of the homelab:

![[Homelab - Layout.excalidraw|100%]]

##

Documentation

This documentation is divided into the following sections:

*

**
• 1. [Hardware](./Hardware.md)Hardware:** An overview of the hardware used in this homelab.
  *
**
• 2. Host Setup:**
  
  *   [
  • Installing Proxmox](./Installing%20Proxmox.md)Proxmox: A step-by-step guide to installing and configuring Proxmox VE.
    
    *  
  • (Optional) [Disabling IPv6](./Disable%20IPv6.md)IPv6: Instructions on how to disable IPv6 on the Proxmox host or inside the LXCs.
    *
  **
• 3. Core Infrastructure:**
  
  *   [
  • Active Directory (SAMBA)](./Active%20Directory%20(SAMBA).md): Setting up a Samba-based Active Directory domain controller.
    
    *  
  • (Optional) [Managing SSL Certificates](./SSL%20Certs.md)Certificates: Creating a custom CA and signing certificates for internal services.
    
    *   [Truenas](./Truenas.md)
  • Truenas: Configuration of TrueNAS for network-attached storage.
    
    *   [AdGuard](./AdGuard.md)
  • AdGuard: Setting up AdGuard for network-wide ad blocking.
    
    *   [
  • NGINX Proxy Manager](./NGINX%20Proxy%20Manager.md)Manager: Configuring NGINX Proxy Manager for reverse proxying services.
    *
  **
• 4. Authentication:**
  
  *   [Authelia](./Authelia.md)
  • Authelia: Implementing Authelia for single sign-on (SSO) and two-factor authentication.
    *
  **
• 5. Services:**
  
  *   [Homepage](./Homepage.md)
  • Homepage: Creating a custom homepage for easy access to services.
    
    *   [Jellyfin](./Jellyfin.md)
  • Jellyfin: Setting up a Jellyfin media server.
    
    *   [Immich](./Immich.md)
  • Immich: Self-hosting Immich for photo and video management.
    
    *   [BookStack](./BookStack.md)
  • BookStack: Hosting a BookStack instance for documentation.

  ##

Getting Started

To get started, you can begin by reviewing the [Hardware](./Hardware.md)Hardware section to understand the physical components of the homelab or you can jump to the [Installing Proxmox](./Installing%20Proxmox.md)Proxmox guide to set up the virtualization host.

---

---