From 51dba947456c1c635df746fa538b5c861623e9a7 Mon Sep 17 00:00:00 2001 From: Joshua Yuen Date: Sat, 12 Sep 2026 00:22:06 -0400 Subject: [PATCH] Update README --- README.md | 31 +++++++++++++++++++++---------- 1 file changed, 21 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 9c64d7e..231c8ac 100644 --- a/README.md +++ b/README.md @@ -1,28 +1,37 @@ + # Installing on a new machine 1) Install [NixOS](https://nixos.org/) from an ISO via USB 2) Reboot machine -3) Edit `/etc/nixos/configuration` and add `git` to packages +3) Edit `/etc/nixos/configuration.nix` and add `git` to packages 4) Clone this repo -5) Copy new `host/` configuration for the new machine -6) Copy `/etc/nixos/hardware-configuration` to `host//hardware.nix` -7) Edit `flake.nix` to point to the new `host` +5) Create a new directory under `hosts/` for the new machine +6) Copy `/etc/nixos/hardware-configuration.nix` to `hosts//hardware.nix` +7) Register the host in `flake.nix` via `mkHost`: + ```nix + nixosConfigurations. = mkHost { host = ""; }; + ``` 8) `git add .` -9) Run `sudo nixos-rebuild switch --flake .#nixos` +9) Run `sudo nixos-rebuild switch --flake .#` # Building NixOS VM -`nix build .#nixosConfigurations.nixosvm.config.system.build.vm` +`nix build .#nixosConfigurations.vm.config.system.build.vm` + +or run `./build-vm.sh` (removes `./vm.qcow2` first) + https://gist.github.com/FlakM/0535b8aa7efec56906c5ab5e32580adf # Building NixOS ISO `nix build .#nixosConfigurations.live.config.system.build.isoImage` +or run `./build-iso.sh` + # Using Standalone Home Manager 1) Install [Nix](https://nixos.org/) via: -` +``` sh <(curl --proto '=https' --tlsv1.2 -L https://nixos.org/nix/install) --daemon -` +``` 2) Create `~/.config/nix/nix.conf` file with the following contents to enable the use of flakes: ``` @@ -31,17 +40,19 @@ experimental-features = nix-command flakes 3) Install `git` 4) Clone this repo 5) Edit `flake.nix` variables as needed -6) `home-manager switch --flake .` +6) `home-manager switch --flake .#josh` # Misc ## Garbage collection `nix-collect-garbage -d` + ## Fonts ### Checking installed fonts `fc-list` + ### Debugging kitty fonts `kitty --debug-font-fallback` ## SDDM virtual keyboard ??ZZ - https://unix.stackexchange.com/questions/43976/list-all-valid-kbd-layouts-variants-and-toggle-options-to-use-with-setxkbmap -- https://github.com/NixOS/nixpkgs/issues/254523 \ No newline at end of file +- https://github.com/NixOS/nixpkgs/issues/254523