My Nix Config

This repository contains my Nix configurations. Feel free to explore and use any part that inspires you.

Features:

• Single flake setup
• Agenix for secrets management
• Home-Manager integration
• Modularization
• Automatic module options documentation generation at https://nix.rasmuskirk.com/
• Pi-based NAS setup

Directions:

• configurations/home-manager:
  • Home-Manager configurations for my devices (deck, Pi, and work).
• configurations/nixos:
  • NixOS configurations for my devices (Pi).
• modules/home-manager:
  • Home-Manager modules generalizing configuration for various tools.
• modules/nixos:
  • NixOS modules generalizing configuration for various tools.
• pubkeys:
  • Public keys for my devices.
• docs:
  • Files required for building the documentation hosted at https://nix.rasmuskirk.com/.

The Configurations

The Home-Manager configurations are fairly straightforward since they mostly reuse modules, but the NixOS configuration has some notable features:

• Agenix for secrets management
• Nixarr integration
• Syncthing
• SSH tunneling
• Sudo insults

The Modules

The modules allow configuration to be reused efficiently and without duplication between machines. For example, I want to share configuration between my Pi-based NAS and my work laptop for programs such as my editor, file manager, git, shell and more.

An example follows below:

Snippet from Work Laptop's Configuration

  kirk = {
    helix.enable = true;
    yazi = {
      enable = true;
      configDir = configDir;
    };
    git = {
      enable = true;
      userEmail = "[email protected]";
      userName = "rasmus-kirk";
    };
    zsh.enable = true;
    fonts.enable = true;
    terminalTools.enable = true;
  };

Snippet from NAS/Pi Configuration

  kirk = {
    helix = {
      enable = true;
      installMostLsps = false;
      extraPackages = with pkgs; [ nil marksman nodePackages_latest.bash-language-server ];
    };
    yazi = {
      enable = true;
      configDir = configDir;
    };
    git = {
      enable = true;
      userEmail = "[email protected]";
      userName = "rasmus-kirk";
    };
    zsh.enable = true;
    fonts.enable = true;
    terminalTools.enable = true;
  };

Importing Modules

The options I’ve created allow for different behaviors across devices, while avoiding redundant configuration snippets. Although these modules are designed for personal use, it's possible for others to reuse them:

{
  description = "My NixOS configuration";

  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";

    kirk-modules.url = "github:rasmus-kirk/nix-config";
    kirk-modules.inputs.nixpkgs.follows = "nixpkgs";

    home-manager.url = "github:nix-community/home-manager/release-23.11";
    home-manager.inputs.nixpkgs.follows = "nixpkgs";
  };

  outputs = inputs @ {
    self,
    nixpkgs,
    kirk-modules,
    flake-parts,
    ...
  }: let
    inherit (self) outputs;
  in {
    homeConfigurations = {
      myMachine = home-manager.lib.homeManagerConfiguration {
        pkgs = nixpkgs.legacyPackages.x86_64-linux;
        extraSpecialArgs = { inherit inputs outputs; };
        modules = [
          ./configurations/home-manager/my-machine/home.nix
          kirk-modules.homeManagerModules.default
        ];
      };
    };
  };
}

Automatically Generated Module Documentation

The Nix modules include built-in compilation of module options to Markdown. I further convert this Markdown into HTML using Pandoc, which is then deployed via GitHub Pages. You can find the module documentation here. For more details, see the ./docs directory.