My personal homelab infrastructure, fully managed with NixOS and Clan. This repository contains all configurations for my servers, desktops, and network devices.
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.
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
- 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
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.
All Available homelab features :
My workstations run a customized NixOS setup with i3 window manager and various productivity tools.
| 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 |
Quick access to system controls via i3 floating terminals:
| Bluetooth Manager | Disk Manager |
|---|---|
![]() |
![]() |
bluetuith |
bashmount |
| Audio Mixer | Network Manager |
|---|---|
![]() |
![]() |
pulsemixer |
nmtui |
๐ 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
๐ป Gagarin Workstation
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
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 |
A big thank to the contributors of OpenSource projects in particular :
- clan project Simplest way to re-enter independent computing with our framework
- doctor-cluster-config from German TUM School of Computation
- Mic92 and for his some nix contributions
- Misterio77 and for his some nix contributions
- longerHV nix configuration file
- wikipedia for logos inventories






