- Nix 100%
| .gitignore | ||
| configuration.nix | ||
| disko.nix | ||
| flake.lock | ||
| flake.nix | ||
| hardware-configuration.nix | ||
| LICENSE | ||
| README.md | ||
| wireguard.nix | ||
Lyrix — NixOS Homelab Configuration
Declarative NixOS configuration for Lyrix, an Intel N100-based homelab server.
This repository contains the complete NixOS Flake and Disko configuration used to install and manage the server.
Hardware
| Component | Specification |
|---|---|
| System | Intel N100 mini PC |
| Architecture | x86_64 |
| RAM | 16 GB planned |
| Primary storage | 512 GB NVMe |
| Secondary storage | 4 TB WD external HDD |
| Hostname | lyrix |
| Operating system | NixOS 26.05 |
Repository structure
nixos-lyrix/
├── flake.nix
├── flake.lock
├── configuration.nix
├── hardware-configuration.nix
├── disko.nix
├── README.md
└── .gitignore
| File | Purpose |
|---|---|
flake.nix |
NixOS system definition and inputs |
flake.lock |
Pinned dependency versions |
configuration.nix |
Main system configuration |
hardware-configuration.nix |
Hardware-specific settings |
disko.nix |
NVMe partitioning and filesystem layout |
.gitignore |
Excludes generated build artifacts |
Storage layout
Primary NVMe
The 512 GB NVMe contains the NixOS installation:
- 1 GB EFI System Partition mounted at
/boot - Remaining space formatted as ext4 and mounted at
/
Warning: Disko will erase and repartition the configured NVMe during installation.
Secondary storage
The 4 TB WD external HDD is a separate existing ZFS pool.
It is intentionally excluded from disko.nix so reinstalling NixOS does not automatically repartition or format it.
ZFS support is enabled in the system configuration. The pool is managed separately from the operating system installation.
Configuration features
- NixOS Flakes
- Disko declarative disk configuration
- systemd-boot
- NetworkManager
- OpenSSH
- SSH public-key authentication
- Firewall disabled
- ZFS filesystem support
- Persistent ZFS host ID
- Minimal, headless server environment
lyrexoadministrator account with sudo
Building
Build the system configuration from a Linux machine with Nix installed:
nix --extra-experimental-features 'nix-command flakes' \
build .#nixosConfigurations.lyrix.config.system.build.toplevel
Deploying
Install or deploy the configuration using NixOS Anywhere:
nix --extra-experimental-features 'nix-command flakes' \
shell nixpkgs#nixos-anywhere nixpkgs#disko
Then:
nixos-anywhere --flake .#lyrix root@SERVER_IP
Important: Deployment is destructive to the NVMe specified in disko.nix. Verify the target disk identifier and back up important data before proceeding.
The existing 4 TB ZFS drive is not a Disko target.
Updating the configuration
After modifying the configuration:
nix --extra-experimental-features 'nix-command flakes' \
build .#nixosConfigurations.lyrix.config.system.build.toplevel
Commit and push changes:
git add .
git commit -m "Update Lyrix configuration"
git push
Repository
github.com/MaseDev33/homelab-nix-config
Maintained as the declarative configuration for Lyrix.