hhhh/dotfiles
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

refactor: update README for nixos setup

Browse source
This commit is contained in:
hhhh hgfh 2026-10-03 13:15:51 +00:00
parent e292dabfa4
commit 996f092171
1 changed files with 51 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

52
README.md
View file

@ -25,7 +25,9 @@ sanitizer-assisted test runs, `perf`, FlameGraph, and systemd user scopes.
```text
.
├── .bashrc # Bash environment, aliases, and helper functions
├── flake.nix # Reproducible NixOS entry point
├── nixos/ # Host and reusable NixOS modules
├── bash/ # Bash environment, aliases, and helper functions
├── atuin/ # Atuin configuration
├── gitui/ # GitUI key bindings
├── kitty/ # Kitty settings and color themes
@ -36,6 +38,54 @@ sanitizer-assisted test runs, `perf`, FlameGraph, and systemd user scopes.
Starship, direnv, zoxide, fzf, and eza do not currently have dedicated
configuration directories tracked in this repository.
## NixOS
The flake exposes the `nixos` host. Its machine-specific configuration lives
in `nixos/hosts/nixos`, while reusable settings are grouped by purpose in
`nixos/modules`. Packages are split into desktop, development, shell, and
general utility modules under `nixos/modules/packages`.
From the repository root, check and apply the configuration with:
```bash
nix flake check
sudo nixos-rebuild switch --flake .#nixos
```
On the first run, if flakes are not enabled in the currently booted system,
pass the feature flags explicitly:
```bash
sudo nixos-rebuild switch \
--extra-experimental-features 'nix-command flakes' \
--flake .#nixos
```
Update the pinned Nixpkgs revision and rebuild with:
```bash
nix flake update
sudo nixos-rebuild switch --flake .#nixos
```
Codex is taken from a separately pinned Nixpkgs `master` input so it can be
updated without upgrading the stable NixOS package set:
```bash
nix flake update codex-nixpkgs
sudo nixos-rebuild switch --flake .#nixos
```
The `codex-background-server` user service starts automatically when `hhhh`
logs in and listens on the local Unix socket. Connect with
`codex --remote unix://`. Check its status with
`systemctl --user status codex-background-server` and view its logs with
`journalctl --user -u codex-background-server`.
Before using this configuration on another machine, regenerate or replace
`nixos/hosts/nixos/hardware-configuration.nix` and adjust the host name,
user, graphics driver, and `system.stateVersion` as appropriate.
## Installation
Clone the repository, install the tools listed above using your system package