homelab

GitOps-managed homelab using Kubernetes (Talos), ArgoCD, and Terraform for infrastructure as code.

Automatically checked · GitHub checked 2026-11-13

homelab

Overview

Eden

Eden

Homelab Infrastructure

Kubernetes Talos ArgoCD Terraform

Blog Portfolio Container Security

License Last Commit Issues Stars

This is my personal lab for infrastructure experiments and self-hosted services. I work with these technologies every day at work. The homelab gives me the freedom to test ideas and patterns that do not always fit production constraints. Here I test new tools, solve real problems at home, and yes, sometimes break things to learn.

The repository is public by design. Transparency keeps me honest about best practices, also when the work is only for fun.

Network & Service Flow

Click to open the full-size image. Which services talk to each other and how traffic flows through the homelab. Rendered by the pipeline from this file on every push. How to read it.

Live cluster status: applications synced and healthy, nodes ready, pods running, critical alerts, CPU and memory in use, which apps are asleep, and 30-day availability

Drawn every 15 minutes from nordbye.it/api/v1/infra, which a CronJob fills from the Kubernetes API and Prometheus. When the cluster is unreachable the card says so.


Documentation

Read the docs at docs.nordbye.it

Everything in this repo is documented at docs.nordbye.it. The docs describe how the parts connect, and how to operate or rebuild each one.

Every push to main builds the site from docs/. The site always matches this repo.


Writing

Longer write-ups of things built in this repo, on blog.nordbye.it:


Quick Links

Portfolio Blog Docs LinkedIn GitHub

Send me a DM, open a pull request, or copy code from here. The goal is to learn and to make connections.


How It Works

Terraform builds the Talos VMs on Proxmox. Everything after that comes through git.

push to main
   ├─ GitHub Actions builds portfolio and blog, pushes to GHCR
   │     └─ Kargo promotes stage to prod as a pull request you merge
   └─ Argo CD reconciles k8s/talos/** onto the cluster
         ├─ External Secrets fetches credentials at runtime, so none are committed
         ├─ Traefik publishes routes through Gateway API, cert-manager and external-dns handle TLS and DNS
         └─ KEDA lets idle apps drop to zero; the HTTP interceptor wakes them on the first request

Argo CD runs two ApplicationSets in k8s/talos/infra/argocd/. They generate one Application per directory. A new workload is a new directory.


Homelab Overview

Homelab Overview

Click to open the full-size image. A map of the whole homelab — how the hardware, cluster and services fit together. Auto-generated through the pipeline from this file.


Repository Structure

Note: This is a simplified view showing the main folders and key files. The actual repository contains additional directories and configurations.

homelab
├── k8s/talos/
│   ├── apps/                            # Application deployments
│   │   ├── arr-stack/
│   │   ├── blog/
│   │   └── plex-media-stack/
│   └── infra/                           # Infrastructure components
│       ├── argocd/
│       ├── cilium/
│       └── traefik/
├── terraform/
│   ├── azure/
│   │   └── state/                       # Remote state backend
│   └── proxmox/                         # Proxmox cluster IaC
│       └── hyper-cluster/
│           └── k8s/
├── blog/                                # Hugo blog source
│   ├── Dockerfile
│   ├── config/
│   ├── content/
│   └── themes/
├── portfolio/                           # Portfolio site source
│   ├── Dockerfile
│   ├── nginx/
│   └── src/
├── docs/                                # Technical docs, published to docs.nordbye.it
│   ├── architecture/
│   ├── platform/
│   ├── apps/
│   └── backlog/
└── ai/                                  # AI agents, skills, projects, local LLM
    ├── agents/
    ├── skills/
    ├── projects/
    ├── local-llm/
    ├── prompts/
    └── notes/

Kubernetes Tech Stack

CategoryComponents
GitOpsArgo CD (ApplicationSets), Kargo (stage to prod promotion for blog, headroom, logeverylift, portfolio, reelsmith and verksted), Argo Rollouts (installed, no workload uses it yet)
NetworkingCilium (CNI, eBPF, L2 announcements and LB IPAM), Traefik via Gateway API, external-dns (Cloudflare)
SecurityFalco (runtime, modern eBPF probe), Authentik (SSO), cert-manager, External Secrets Operator (Bitwarden Secrets Manager, pattern)
ObservabilityPrometheus and Alertmanager, Grafana, Loki (logs), Tempo (traces), Alloy (log shipping, trace filtering), Pyrra (SLOs and error budgets), metrics-server
ScalingKEDA with the HTTP add-on: nine apps drop to zero replicas and the interceptor wakes them on the first request
AutomationReloader (config and secret triggered rollouts)
StorageProxmox CSI (block), csi-driver-nfs (Synology NFS)
DatabasesPostgreSQL 18 (in-cluster, NFS-backed, behind logeverylift)
PlatformProxmox VE on three Lenovo nodes, Talos Linux (three control plane and three worker VMs), Terraform

Security

Container Vulnerability Scanning

Trivy scans the containers every week and on every Dockerfile change. The scans detect CRITICAL and HIGH severity vulnerabilities in the blog and portfolio containers. The workflow uploads the results to the GitHub Security tab for tracking and remediation.

Runtime Security

Falco runs as a DaemonSet on every node. It detects anomalous activity at the syscall level through a modern eBPF probe. This is the Talos-safe driver, with no kernel module. Falcosidekick routes the detections to Discord. The upstream rules' own template macros tune out false positives, so the signal stays high. Falco metrics feed a Grafana dashboard for a quick view of security.


CI/CD Workflows

WorkflowTriggerPurpose
Build and Deploy BlogPush to main and pull request (blog changes)Lints and builds the Hugo blog; on main pushes to GHCR (Kargo promotes stage → prod)
Build and Deploy PortfolioPush to main and pull request (portfolio changes)Lints, typechecks and builds the image; smoke tests it on PRs, pushes to GHCR on main (Kargo promotes stage → prod)
Container Vulnerability ScanSundays, prod promotion, manualScans the blog and portfolio images prod runs with Trivy, CRITICAL and HIGH with a fix available
Render AssetsPush to main (docs/assets/diagrams/*.d2, docs/assets/logo/source.jpg), manualRenders D2 sources to SVG + PNG and re-crops the logo, commits the result
RemindersMonthly (1st, 8th, 15th), manualDiscord reminders for Kubernetes upkeep, backups, and server updates
Dependency ReviewPRBlocks pull requests that add known-vulnerable dependencies
ScorecardMondays 03:00 UTC, manualOpenSSF supply chain score, published to the Security tab
README CardsEvery 15 minutes, manualRedraws the cluster card at the top of this page and the star chart at the foot of it
Kargo AutomergeKargo promotion PRMerges promotion PRs for the apps listed in KARGO_AUTOMERGE_APPS, where the canary is the real gate
LighthouseMondays 06:00 UTC, manualAudits the live public sites, median of 3 runs, gating SEO, accessibility and best practices
Docs SitePush to main (docs/** and the site config), pull request, manualBuilds docs/ with ProperDocs in strict mode and publishes it to docs.nordbye.it

Hardware

Compute Nodes

NodeModelCPURAMStorage
Hyper1Lenovo ThinkCentre M70q Gen 2Intel Core i5-11400T (6C/12T @ 1.30 GHz)32 GB1 TB
Hyper2Lenovo ThinkCentre M920qIntel Core i5-8500T (6C/6T @ 2.10 GHz)32 GB1 TB
Hyper3Lenovo ThinkCentre M920 TinyIntel Core i7-8700T (6C/12T @ 2.40 GHz)32 GB1 TB

Proxmox Setup Scripts

Community Proxmox VE Helper-Scripts run on each node after install:

ScriptPurpose
Post PVE InstallPost-install tuning — repo sources, subscription nag, updates
NIC Offloading FixDisables NIC hardware offloading to fix interface connectivity issues

Storage

DeviceModelCPURAMCapacityDetails
NASSynology DS1522+AMD Ryzen R1600 (2C @ 2.6 GHz)8 GB3 × 20TB (60TB)SHR, Btrfs, 2 × 1TB NVMe cache · DSM 7.3.2 · hosts a Proxmox Backup Server (PBS) VM

Network Equipment

DeviceModelType
RouterUniFi Cloud GatewayGateway/Router
SwitchUniFi Lite 8 PoEManaged Switch
SwitchUniFi Flex MiniManaged Switch
Access PointUniFi U6+WiFi 6 AP
ModemTeliaCable Modem

IoT & Smart Home

Home Assistant Server

ComponentModelCPURAMStorageOSNetwork
HardwareTopton N100 Fanless Mini PCIntel N100TBD512 GB SSDHome Assistant OS4 × 2.5G i226-V

Devices

DeviceTypePurpose
Philips Hue Bridge ProSmart Lighting HubLighting control
Nabu Casa Connect ZBT-2Zigbee CoordinatorZigbee device coordination
M5Stack Atom LiteBluetooth ProxyBluetooth range extension
UniFi G6 InstantSecurity CameraIndoor surveillance
Nabu Casa Home Assistant Voice Preview EditionVoice SatelliteVoice control (ESPHome, Wi-Fi)
Aqara T1 Temperature and Humidity SensorZigbee Climate SensorIndoor temperature and humidity (ZHA)
Aqara Vibration Sensor T1Zigbee Vibration SensorVibration and tilt detection (ZHA)
Aqara T1 Door and Window SensorZigbee Contact SensorDoor and window open/closed (ZHA)
Aqara T1 Water Leak SensorZigbee Leak SensorWater leak detection (ZHA)

Other Projects

A few other things I build and self-host outside this repo:

ProjectDescriptionStack
logeveryliftMobile-first workout tracking PWANext.js 16, PostgreSQL 18, Drizzle
lawless-wafTune Azure WAF false positives without paying Log Analytics pricesPython, React, Terraform
headroomSelf-hosted personal finance tracker for budgets, assets, investments, and loan modelingTypeScript, SQLite, Docker

Star this repo if it is useful to you

Star history: cumulative stars over time, with the last 30 days, the last 7 days, and the busiest single day

Made by Morten Victor Nordbye