Skip to content

corelab-notes/Homelab

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
Media-stack.png
Media-stack.png
 
 
README.md
README.md
 
 

Repository files navigation

Homelab Atlas

Internet & Networking

  • ISP: Residential cable provider

  • Internet Speed: Gigabit down / 100 Mbps up (nominal)

  • Modem: Bridge modem with builtin firewall (Wi-Fi disabled)

  • Router/Wi-Fi: Wi-Fi 6 mesh router system

    • Main node: wired to the modem, provides the primary Wi-Fi mesh
    • Secondary node: Wi-Fi backhaul to the main node, acts as LAN switch for the self-hosted stack

Topology

graph LR;
  ISP["Residential ISP"] --> Modem["Bridge Modem"];
  Modem -->|LAN| AX1["Wi-Fi 6 Router (AP)"];
  AX1 -.->|Wi-Fi| AX2["Wi-Fi 6 Mesh Node"];

  subgraph SelfHostedStack
    NAS["2-bay NAS (CoreNAS)"];
    NUC["Mini PC (CoreNUC)"];
    Prox["Virtualization Host (CoreProx)"];
  end

  subgraph ExternalNodes
    CloudVM["Free-tier VPS (CoreCloudVM)"];
    CoreProxFR["Edge Mini PC (CoreProxFR)"];
    BackupNAS["Remote NAS (Backup_NAS)"]
  end

  AX2 -->|LAN| NAS;
  AX2 -->|LAN| NUC;
  AX2 -->|LAN| Prox;
  CloudVM -.->|Wireguard/Tailscale| AX1;
  CoreProxFR -.->|Wireguard/Tailscale| AX1;
  BackupNAS -.->|Tailscale| AX1;
Loading

Core Nodes

  • CoreNAS (2-bay NAS chassis)

    • RAM: 18 GB
    • Storage: 2 x 4 TB in SHR
    • Role: NAS
    • Connection: Ethernet → core router

  • CoreNUC (Intel N100 mini PC)

    • CPU: Intel N100

    • RAM: 16 GB

    • OS: Linux Mint XFCE

    • Role: A few docker services (to be retired and turned into a videogame machine)

    • Storage:

      • 512GB NVMe SSD

    • Connection: Ethernet → core router

  • CoreProx (Repurposed laptop host)

    • CPU: Intel i5

    • RAM: 64 GB

    • OS: Proxmox 9

    • Role: Virtualisation host for core workloads (CoreVision streaming, CoreDocs document stack, CoreGate reverse-proxy/security)

    • Storage:

      • 256 GB NVMe original SSD: Proxmox (additional local-zfs)
      • 1 TB NVMe added SSD: primary local-zfs
      • 1 TB USB HDD: PBS backup target (HDD1)
      • DAS: 2 x 16 TB + 2 x 8 TB (MediaZilla3/5, DumpZilla1/2, MediaZilla4, ParityZilla; ext4; served via MergerFS + SnapRAID)

    • Connection: Ethernet → core router

CoreProx: VMs & LXCs

Inventory (authoritative list)

ID Name Type OS Role / Key Services
100 CoreBackup VM PBS Proxmox Backup Server (backups/snapshots)
101 CoreSmart VM Home Assistant OS Home automation platform
102 CoreDock VM Ubuntu 24.04 LTS Primary Docker host for self-hosted services
103 CoreWin VM Windows 11 Windows environment
104 CoreMC VM Debian 13 PufferPanel; Minecraft hosting
105 AdGuard LXC — Network-wide DNS filtering (AdGuard Home)
107 CoreKu VM Kubuntu 25.04 Remote workstation
108 CoreVPN VM Debian 13 WireGuard (bare metal), Authelia, Atuin, ttyd (Docker)
109 CoreCode VM Ubuntu 24.04 LTS Code-Server; Docker repo/workbench
110 CorePlay VM Xubuntu 24.04 LTS Sunshine; emulation & game server
111 CoreGate VM Debian 13 Nginx Proxy Manager with Fail2ban & CrowdSec
112 CoreVision VM Ubuntu 24.04 LTS Streaming stack (Plex, ErsatzTV, Stash)
113 CoreDocs VM Debian 13 Paperless-NGX on encrypted storage

External Nodes

  • CoreCloudVM (free-tier VPS)

    • Arch: x86 (not ARM)
    • Role: Monitoring host (Uptime Kuma)
    • Connectivity: integrated into homelab network via Tailscale + WireGuard

  • Backup NAS (remote 2-bay NAS)

    • Storage: 2 x 2TB in SHR

  • CoreProxFR (remote edge mini PC)

    • CPU: Intel N100
    • RAM: 16 GB
    • Storage: 512 GB SSD
    • OS: Proxmox 9
    • Role: Edge homelab node; hosts AdGuard (LXC) and Home Assistant OS (VM)

CoreProxFR: VMs & LXCs

Name Type OS Role / Key Services
AdGuard (remote) LXC — DNS filtering and blocking for remote site
Home Assistant OS VM Home Assistant OS Home automation stack for remote household

Media & Services

  • CoreNUC

    • Radarr/Sonarr drive qBittorrent downloads into the MediaZilla pool (24TB) for primary media.
    • qBittorrent also targets the DumpZilla pool (16TB) for cold/overflow content.
    • Exposes both pools to CoreVision for streaming workloads.

  • CoreVision (VM @ CoreProx)

    • Plex (reads from MediaZilla)
    • ErsatzTV (reads from DumpZilla)
    • Stash (reads from DumpZilla)

  • CoreNAS

    • Provides shared storage for personal data (2x4TB SHR)

  • CoreDocs (VM @ CoreProx)

    • Paperless-NGX on encrypted storage from CoreProx

  • CoreProx

    • Hosts PBS for VM/LXC backups to HDD1
    • CoreGate VM provides Nginx Proxy Manager with Fail2ban & CrowdSec
graph LR;
  Overseerr --> Arr[Radarr/Sonarr];
  Arr <--> Prowlarr;
  Arr --> qB[qBittorrent];
  qB --> MediaZilla[(MediaZilla MergerFS pool 24TB)];
  qB --> DumpZilla[(DumpZilla MergerFS pool 16TB)];
  MediaZilla --> Plex;
  DumpZilla --> Ersatz[ErsatzTV];
  DumpZilla --> Stash[Stash];
  Ersatz --> Plex;
  Paperless[Paperless-NGX] --> Crypt[(5GB encrypted volume from CoreProx)];
  Prox[Proxmox Backup Server VM] --> HDD1[(1TB HDD Backup)];

  subgraph CoreProx
    Prox;

    subgraph CoreVision [CoreVision VM]
      Plex;
      Ersatz;
      Stash;
    end

    subgraph CoreDock [CoreDock VM]
      Arr;
      qB;
      Overseerr;
      Prowlarr;
    end

    subgraph CoreDocs [CoreDocs VM]
      Paperless;
    end

  subgraph Storage
    Crypt;
    HDD1;
    MediaZilla;
    DumpZilla;
  end

  end

style Storage fill:#c9ffd8;
Loading

DAS Layout & Media Stack

  • All DAS disks use ext4 and attach directly to CoreProx.
  • Disk map:
    • 16 TB → MediaZilla3 (8 TB) + DumpZilla1 (8 TB)
    • 16 TB → MediaZilla5 (8 TB) + DumpZilla2 (8 TB)
    • 8 TB → MediaZilla4 (8 TB)
    • 8 TB → ParityZilla (8 TB, SnapRAID parity)
  • MergerFS logical pools:
    • MediaZilla (MediaZilla3 + MediaZilla4 + MediaZilla5) → 24 TB aggregate media volume.
    • DumpZilla (DumpZilla1 + DumpZilla2) → 16 TB aggregate volume.
  • SnapRAID uses ParityZilla to protect the MediaZilla pool.

Media stack layout showing MediaZilla3/4/5, DumpZilla1/2, and ParityZilla on their respective disks, plus MergerFS and SnapRAID relationships

Backup Strategy

  • CoreNAS

    • Important content → Cloud Storage nightly (HyperBackup)
    • Important content → Remote NAS (offsite) nightly (HyperBackup)

  • CoreNUC

    • Full backup → HDD1 nightly (PBS)

  • CoreProx

    • VMs & LXCs → HDD1 nightly (PBS)
    • HDD1 → Cloud Storage nightly (rclone)

  • CoreProxFR

    • VMs & LXCs → HDD1 nightly (PBS)
graph LR;
  NASVol[(CoreNAS SHR 2x4TB)] -. HyperBackup nightly .-> CloudStore[(Cloud storage provider)];
  NASVol -. HyperBackup nightly .-> BackupNAS[Backup NAS];

  CoreNUC -. PBS nightly .-> PBS[Proxmox Backup Server];

  CoreProxFR[CoreProxFR VMs and LXCs] -. PBS nightly .-> PBS;

  CoreProx[CoreProx VMs and LXCs] -. PBS nightly .-> PBS;
  PBS --> HDD1[(USB HDD 1TB)];
  HDD1 -. rclone nightly .-> CloudStore;
Loading

Backup Policy (Summary)

Scope Source Tool Target Frequency
NAS important content CoreNAS (2x4TB SHR) HyperBackup Cloud Storage Nightly
NAS important content CoreNAS (2x4TB SHR) HyperBackup Remote NAS (offsite) Nightly
Host backups CoreNUC PBS (CoreBackup) HDD1 (USB 1TB) Nightly
VMs & LXCs CoreProx PBS (CoreBackup) HDD1 (USB 1TB) Nightly
VMs & LXCs (remote) CoreProxFR PBS (CoreBackup) HDD1 (USB 1TB) Nightly
PBS offsite HDD1 rclone Cloud Storage Nightly

IP Reference

Node / Service LAN IP WireGuard IP(s) Tailscale IP
CoreNAS 192.168.10.24 – 100.64.201.112
Backup NAS – – 100.64.95.61
CoreNUC 192.168.10.193 – 100.64.71.13
CoreProx 192.168.10.2 – 100.64.115.8
AdGuard 192.168.10.230 – –
CoreCode 192.168.10.233 – –
CoreVPN 192.168.10.21 10.50.50.1 –
CoreBackup 192.168.10.201 – –
CoreMC 192.168.10.209 – –
CoreKu 192.168.10.148 – –
CoreWin 192.168.10.239 – –
CorePlay 192.168.10.53 – –
CoreDock 192.168.10.49 – –
CoreVision 192.168.10.197 – –
CoreDocs 192.168.10.190 – –
CoreGate 192.168.10.180 – –
CoreSmart 192.168.10.25 – –
Remote Home Assistant 10.40.0.28 – –
CoreCloudVM – 10.50.50.6 100.64.254.30
CoreProxFR 10.40.0.22 10.50.50.20 100.64.254.32
Workstation Laptop 192.168.10.124 10.50.50.4 (split), 10.50.50.5 (full) 100.64.11.39
Personal Phone 192.168.10.232 10.50.50.2 (split), 10.50.50.3 (full) 100.64.220.42
Family Phone – 10.50.50.50 –

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

3 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published