NixOS config

This is my NixOS config, plus some tooling for managing its inputs without flakes.

Note

This repo is relatively inactive as my NixOS system itself is mostly serving as a host for k3s - most work on my system is happening in the kubernetes configuration.

Structure of this repo

hosts

Definitions for hosts are found in hosts/default.nix, with a few fields:

• system: (required) The system (e.g., x86_64-linux, aarch64-darwin, ...) the host runs on.

• config: (required) The base module of the host's configuration. By convention, this is typically hosts/HOSTNAME/default.nix, but it doesn't have to be.

• nixpkgs: (required) A nixpkgs source that the host's config will be built against. This uses sources (see below) to get the path to a nixpkgs source tree, and then the build will combine this with the host's system and overlays to instantiate the nixpkgs used to go on and build the system.

• overlays: (optional) A list of overlays to apply to nixpkgs when building this host.

overlays

Overlays to be applied to nixpkgs. One overlay per nix file, defined directly at the top level of that file.

nix

Configuration for Nix itself. At time of writing, it configures automatic garbage collection and trusted users for substituters, and enables flake support in Nix tooling, including creating entries in the flake registry for the nixpkgs inputs used to build the system.

programs

Configuration for programs that need more than simply having their packages added to the user environment:

• neovim

• starship

• tmux

services

Configuration for services:

• Tailscale

users

Configuration for users:

• rj

sources.json and sources.nix

Sources for the inputs used to build configurations. The tooling updates data in the JSON file, and sources.nix imports that data and uses builtins.fetchTree to retrieve the referenced sources.

sources.sh

Simple shell script to manage sources.json. Currently only supports git sources, though I do want to expand it to support builtins.fetchTree's other source types eventually.

build.sh and build.nix

Shell script and nix file that wrap switch-to-configuration, providing a less featureful but lighter alternative to nixos-rebuild. They build and optionally activate the configuration defined in hosts for a given hostname (by default, the current hostname of the system they're running on).