nixos-config/README.md

This repository contains the Nix / NixOS configuration for all of my systems. Start from flakes.nix (see Flakes).

To build,

# First, edit nixosConfigurations in flake.nix to add your system's hostname.
# And then change `userName` to your username.
nix develop -c , activate

Install notes

• NixOS Linux
  • Install NixOS
    • Hetzner dedicated from Linux Rescue system: https://github.com/serokell/nixos-install-scripts/pull/1#pullrequestreview-746593205
    • Digital Ocean: https://github.com/elitak/nixos-infect
    • X1 Carbon: https://www.srid.ca/x1c7-install
    • Windows (via WSL): https://github.com/nix-community/NixOS-WSL
  • Clone this repo at /etc/nixos
  • Edit flake.nix to use your system hostname in the nixosConfigurations set
  • Edit users/config.nix to contain your users
  • Run nix develop -c , activate. That's it. Re-open your shell.
• macOS:
  • Install Nix normally (multi-user)
  • Install nix-darwin
    • This will create a ~/.nixpkgs/darwin-configuration.nix, but we do not need that.
  • Clone this repo anywhere
  • Edit users/config.nix to contain your users
  • Run nix develop -c , activate.¹ That's it. Re-open your terminal.

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
• secrets: agenix secrets (encrypted using ssh keys)
• systems: top-level configuration.nix('ish) for various systems

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
    # Also, in the dev shell: , update-primary
    

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

---

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