Skip to content

badele/nix-homelab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation


Centralize the configuration of your immutable NixOS machines

My personal homelab infrastructure, fully managed with NixOS and Clan. This repository contains all configurations for my servers, desktops, and network devices.

Home | Public Server | Grafana Dashboard | My bookmarks


What is this?

This is a complete NixOS homelab setup that manages:

  • Servers: Public VPS (Hetzner, Infomaniak), physical servers, Raspberry Pi
  • Desktops: Personal laptops and workstations

Everything is declarative, reproducible, and version-controlled whenever possible.

Why Clan?

I'm using Clan to simplify infrastructure management:

Backbone of independent infrastructure

Or as I like to say:

Kill the cloud, build your darkcloud โ˜๏ธ

โ†’ Learn more about Clan and why I use it

Key benefits

  • Simple host management: Easy inventory system
  • Automatic secrets: Built-in secret generation and management
  • Backup made easy: Integrated backup solution
  • Declarative: Everything in code, no manual steps

๐Ÿ› ๏ธ Deployment Strategy

I follow a hybrid approach:

  • NixOS services first: Most applications run as native NixOS services
  • Podman when needed: Some apps use containers to:
    • Use plugins or features not well-supported in NixOS (e.g., DokuWiki)
    • Avoid service interruptions during system updates
    • Maintain stability during version upgrades

This gives me the best of both worlds: NixOS reproducibility with container flexibility.

๐Ÿ“ฆ Services & Applications

All Available homelab features :

ACME
ACME
Authelia
Authelia
authentik
authentik
Blocky
Blocky
DokuWiki
DokuWiki
Gatus
Gatus
GoAccess
GoAccess
Grafana
Grafana
grist
grist
Homepage
Homepage
it-tools
it-tools
Kanidm
Kanidm
Linkding
Linkding
LLDAP
LLDAP
Miniflux
Miniflux
Nix homelab summary
Nix homelab summary
Pawtunes
Pawtunes
Radio
Radio
Sample Podman application
Sample Podman application
Shaarli
Shaarli
Step CA
Step CA
Tailscale
Tailscale
Victoriametrics
Victoriametrics
Wastebin
Wastebin

๐Ÿ’ป Desktop Environment

My workstations run a customized NixOS setup with i3 window manager and various productivity tools.

Desktop Applications

Logo Application Description
borgbackup Deduplication backup tool
Firefox Web browser
Gimp Raster graphics editor
i3 Tiling window manager
Inkscape Vector graphics editor
LibreOffice Office suite
Meld Visual diff tool
Navi Interactive cheatsheet tool
Neovim VIDE - My customized Neovim config

Floating TUI Panels

Quick access to system controls via i3 floating terminals:

Bluetooth Manager Disk Manager
bluetuith bashmount
Audio Mixer Network Manager
pulsemixer nmtui

๐ŸŒ Infrastructure

๐Ÿš€ Houston Server

My main public VPS running on Hetzner Cloud (CX32: 4 vCPU, 8GB RAM, 80GB SSD).

What it does:

  • ๐Ÿ” Authentication Hub: Authelia + LLDAP for SSO across all services
  • ๐Ÿ“Š Full Observability Stack: Grafana, VictoriaMetrics, Telegraf, Vector
  • ๐Ÿ“ฑ Self-Hosted Apps: DokuWiki, Linkding, Miniflux, Shaarli, and more

โ†’ See complete service list and details

My main desktop workstation for daily development and productivity.

Setup:

  • ๐ŸชŸ i3 Tiling WM: Efficient workspace management with custom keybindings
  • ๐Ÿ› ๏ธ Full Dev Environment: VIDE (Neovim), VS Code, Git, Docker, and more
  • ๐ŸŽจ Creative Tools: GIMP, Inkscape, LibreOffice
  • โš™๏ธ System Management: TUI panels for quick access to system controls

โ†’ See complete configuration and tools

All Hosts

Complete list of hosts in the homelab (auto-generated with just doc-update):

Logo Name OS Description
boxย (192.168.0.1) Sagem SFR internet box
router-livingย (192.168.254.254) MikroTik Livingroom mikrotik router
router-ladbedroomย (192.168.254.253) MikroTik Bedroom mikrotik router
router-homeofficeย (192.168.254.252) MikroTik Office mikrotik router
sadhomeย (192.168.254.200) NixOS Stephanie's laptop
rpi40ย (192.168.254.101) NixOS The RPI 4 server
bootstoreย (192.168.254.100) NixOS HP Microserver N40L server
b4d14ย (192.168.254.124) NixOS Dell XPS 9560 Latop
badxpsย (192.168.254.114) NixOS Dell XPS 9570 Latop
vm-testย (127.0.0.1) NixOS qemu VM (SSH on port 2222)
cab1eย (84.234.31.97) NixOS Wireguard VPN anonymizer server
houstonย (91.99.130.127) NixOS Main public server
gagarinย (192.168.254.147) NixOS My main desktop workstation

Network Topology

Network diagram

Common Commands

Available commands

โค๏ธ Thanks

A big thank to the contributors of OpenSource projects in particular :

About

Homelab and dotfiles made with NixOS

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published