Skip to main content

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):** An overview of the hardware used in this homelab.
*   **2. Host Setup:**
    *   [Installing Proxmox](./Installing%20Proxmox.md): A step-by-step guide to installing and configuring Proxmox VE.
    *   (Optional) [Disabling IPv6](./Disable%20IPv6.md): 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): Creating a custom CA and signing certificates for internal services.
    *   [Truenas](./Truenas.md): Configuration of TrueNAS for network-attached storage.
    *   [AdGuard](./AdGuard.md): Setting up AdGuard for network-wide ad blocking.
    *   [NGINX Proxy Manager](./NGINX%20Proxy%20Manager.md): Configuring NGINX Proxy Manager for reverse proxying services.
*   **4. Authentication:**
    *   [Authelia](./Authelia.md): Implementing Authelia for single sign-on (SSO) and two-factor authentication.
*   **5. Services:**
    *   [Homepage](./Homepage.md): Creating a custom homepage for easy access to services.
    *   [Jellyfin](./Jellyfin.md): Setting up a Jellyfin media server.
    *   [Immich](./Immich.md): Self-hosting Immich for photo and video management.
    *   [BookStack](./BookStack.md): Hosting a BookStack instance for documentation.

## Getting Started

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

---