dotfiles/nixos-config: KISS NixOS configuration based on Flakes & flake-parts (supports macOS too)

mirror of https://github.com/srid/nixos-config.git synced 2025-12-26 15:04:59 +08:00

KISS NixOS configuration based on Flakes & flake-parts (supports macOS too)

Find a file

Sridhar Ratnakumar 497b49f5b2 readme: hetzner instructions		2024-02-13 03:51:38 -05:00
.vscode	.vscode: add nushell	2023-06-28 15:19:24 -04:00
home	add nix-index db	2024-02-10 03:03:28 -05:00
nix-darwin	Resolve #31	2023-10-29 10:38:41 -04:00
nixos	readOnly	2024-02-13 03:37:27 -05:00
packages	add actual	2024-01-19 13:00:05 +05:30
systems	new server configuration	2024-02-13 03:48:02 -05:00
users	Rm redundant args	2023-07-15 11:49:19 -04:00
.envrc	flake'ify shell.nix	2022-05-08 10:25:46 -04:00
.gitattributes	Add jenkins (#34 )	2023-03-20 14:32:03 -04:00
.gitignore	add direnv	2022-04-28 14:47:41 -04:00
.sops.yaml	sops: yaml -> json	2023-05-15 12:22:47 -04:00
flake.lock	update disko	2024-02-13 03:48:14 -05:00
flake.nix	new server configuration	2024-02-13 03:48:02 -05:00
Jenkinsfile	add Jenkins CI	2023-07-13 16:47:27 -04:00
README.md	readme: hetzner instructions	2024-02-13 03:51:38 -05:00
secrets.json	Containerize github runners (#41 )	2024-01-27 07:17:39 -05:00

README.md

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/tutorial/nixos-install

Install NixOS
- Hetzner dedicated from Linux Rescue system: https://github.com/numtide/nixos-anywhere (see blog post; example PR: https://github.com/srid/nixos-config/pull/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
Install nix-darwin
- This will create a ~/.nixpkgs/darwin-configuration.nix, but we do not need that.
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
secrets.yaml (and .sops.yaml): sops-nix secrets
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
# 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 run nixpkgs#nixci

Discussion

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

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