Skip to content

nickyjacobs/JacOps-Homelab

Repository files navigation

JacOps Homelab

🇬🇧 English | 🇳🇱 Nederlands

JacOps Homelab & Infrastructure

License: MIT Status Made with

Security-first homelab by JacOps. Portfolio and runbook in one.

About

This repository documents the design and build of a segmented homelab network. It serves two purposes. First as a portfolio piece that shows how I approach network security, segmentation and remote access. Second as a personal runbook so I can rebuild the same setup from scratch when needed.

The homelab runs on a Proxmox cluster behind a UniFi Cloud Gateway, with zone-based firewalling, VLAN segmentation and WireGuard for remote access. Every design decision is documented with the reasoning behind it.

This first release covers the network layer end to end. Proxmox cluster and self-hosted services documentation follow in later iterations.

Navigation

Section Description
network/ Architecture, VLANs, zone-based firewall, WireGuard VPN, hardening
proxmox/ Cluster setup, hardening, backups, storage, networking, VM hygiene, monitoring
hardware/ Physical equipment: YubiKey hardware 2FA
services/ Self-hosted services: n8n, Uptime Kuma, ntfy, Vaultwarden, Forgejo, Forgejo Runner, Miniflux, step-ca, Traefik, Beszel
docs/ Design decisions and lessons learned

Tech stack

  • Gateway: UniFi Cloud Gateway Ultra
  • Switching: UniFi USW-Lite-8-PoE
  • WiFi: UniFi U6 Pro
  • Hypervisor: Proxmox VE 9.x cluster (2 nodes)
  • VPN: WireGuard with dynamic DNS
  • Reverse proxy: Traefik v3.6 central with automatic ACME certificates
  • PKI: step-ca as internal ACME server with two-tier PKI
  • Monitoring: Uptime Kuma (reachability) plus Beszel (host metrics), self-hosted ntfy for alerts
  • Backups: Proxmox Backup Server with dedup and verify
  • Automation: n8n
  • Security tooling: Wazuh (planned after eJPT)

Status

Area State
Network architecture documented Done
VLAN segmentation documented Done
Zone-based firewall documented Done
WireGuard remote access documented Done
Cybersecurity hardening documented Done
Design decisions documented Done
Lessons learned documented Done
Proxmox cluster setup documented Done
Proxmox hardening documented Done
Proxmox Backup Server documented Done
Proxmox storage documented Done
Proxmox networking documented Done
Proxmox VM and container hygiene documented Done
Proxmox monitoring documented Done
YubiKey hardware 2FA documented Done
n8n service documented Done
Uptime Kuma service documented Done
ntfy service documented Done
Vaultwarden password vault documented Done
Forgejo Git forge documented Done
Forgejo Runner CI/CD documented Done
Miniflux RSS reader documented Done
step-ca internal ACME server documented Done
Traefik central reverse proxy documented Done
Beszel host metrics monitoring documented Done

About JacOps

JacOps is the freelance brand of Nicky Jacobs, a SOC analyst and security engineer based in the Netherlands. Focus areas are detection engineering, network security and security automation.

License

MIT

About

My security-first homelab

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages