About this project

This repository contains yzx9's personal Nix configuration for managing systems across NixOS, nix-darwin, and standalone home-manager. It provides a structured approach to declarative system configuration, including host-specific setups, custom package builds, and deployment workflows. The configuration supports multiple host types, with a documented process for adding new hosts that involves creating host configuration files, managing secrets with agenix, and deploying via a justfile. A notable feature is Raspberry Pi support through nixos-raspberrypi, which builds ready-to-flash SD card images directly from flake outputs, baking in the full system configuration for immediate deployment. The README includes extensive troubleshooting documentation covering common issues such as substituter activation, macOS daemon management, agenix secret handling, proxy configuration with systemd overrides, and NVIDIA driver version mismatches. It also provides examples for overriding packages, including Rust applications and Vim plugins, demonstrating practical patterns for customizing nixpkgs.