the nix config files for my homelab
Find a file
2026-11-19 09:21:15 -05:00
.gitignore ignore extra-files 2026-11-17 15:49:12 -05:00
configuration.nix fix ssh + make nixos unstable 2026-11-19 09:21:15 -05:00
disko.nix Initial Lyrix NixOS configuration 2026-11-16 20:20:29 -05:00
flake.lock fix ssh + make nixos unstable 2026-11-19 09:21:15 -05:00
flake.nix fix ssh + make nixos unstable 2026-11-19 09:21:15 -05:00
hardware-configuration.nix Initial Lyrix NixOS configuration 2026-11-16 20:20:29 -05:00
LICENSE Add MIT license 2026-11-16 20:22:46 -05:00
README.md Add project README 2026-11-16 20:22:04 -05:00
wireguard.nix wireguard and fixes 2026-11-17 15:48:46 -05:00

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
  • lyrexo administrator 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.