This repository contains the Nix / NixOS configuration for all of my systems. See nixos-flake if you want to create your own configuration from scratch.

Setup

To use this repository as base configuration for your new machine running:

NixOS Linux

Tip

For a general tutorial, see https://nixos.asia/en/nixos-install-flake

• Install NixOS
  • Hetzner dedicated from Linux Rescue system: https://github.com/numtide/nixos-anywhere (see blog post; example PR: #35 where I had to configure networking manually)
    • Copy from existing configuration (eg: ax41.nix)
    • Make networking configuration changes.
    • Run nixos-anywhere from a Linux system, targetting root@<ip>
    • Wait for reboot; ssh srid@<ip>; profit!
  • Digital Ocean
    • Legacy/manual approach: nixos-infect
    • Modern/automate approach: Custom image + colerama; cf. Zulip and example
  • X1 Carbon: https://srid.ca/x1c7-install
  • Windows (via WSL): https://github.com/nix-community/NixOS-WSL
• Clone this repo anywhere
• Edit flake.nix to use your system hostname as a key of the nixosConfigurations set
• Edit users/config.nix to contain your users
• Run nix run. That's it. Re-open your terminal.

macOS

• Install Nix
• Clone this repo anywhere
• Edit flake.nix to use your system hostname as a key of the darwinConfigurations set
• Edit users/config.nix to contain your users
• Run nix run.¹ That's it. Re-open your terminal.

Architecture

Start from flake.nix (see Flakes). flake-parts is used as the module system.

Directory layout

• home: home-manager config (shared between Linux and macOS)
• nixos: nixos modules for Linux
• nix-darwin: nix-darwin modules for macOS
• users: user information
• systems: top-level configuration.nix('ish) for various systems
• clusters: Features that span more than 1 system

Tips

• To update NixOS (and other inputs) run nix flake update
  • You may also update a subset of inputs, e.g.

    nix flake lock --update-input nixpkgs --update-input darwin --update-input home-manager
    # Or, `nix run .#update`

• To free up disk space,

  sudo nix-env -p /nix/var/nix/profiles/system --delete-generations +2
  sudo nixos-rebuild boot

• To autoformat the project tree using nixpkgs-fmt, run nix fmt.
• To build all flake outputs (locally or in CI), run nix --accept-flake-config run github:srid/nixci
• For secrets management, I use colmena along with 1Password.

Discussion

If you wish to discuss about this config, join the Zulip.

Footnotes

1. You might have to rm -rf /etc/nix/nix.conf, so our flake.nix can do its thing. ↩