28 lines
983 B
Markdown
28 lines
983 B
Markdown
# NixOS Repository Quick Reference
|
|
|
|
## Quick Commands
|
|
- **Test build**: `nixos-rebuild build --flake .#<system>`
|
|
- **List systems**: `nix flake show`
|
|
- **Commit**: `git add files && git commit -m "msg"`
|
|
|
|
## Systems
|
|
- **warp**: Server + nginx + forgejo
|
|
- **skip**: Server + nginx only
|
|
- **framework/aurora/labrizor**: Desktop systems
|
|
|
|
## Key Files
|
|
- `flake.nix`: System definitions
|
|
- `systems/<name>.nix`: Hardware/boot configs
|
|
- `servers/<name>.nix`: Service configs
|
|
- `users/<name>.nix`: User configs
|
|
|
|
## Testing Workflow
|
|
1. Always `git status` first - affects flake evaluation
|
|
2. Stage changes (`git add`) before building - prevents Nix store issues
|
|
3. Test with `nixos-rebuild build --flake .#<system>`
|
|
4. Check success message: `"Done. The new configuration is /nix/store/..."`
|
|
|
|
## Important
|
|
- Server configs may contain hardcoded credentials - use agenix or systemd credentials for production
|
|
- Both warp and skip build successfully
|
|
- Repository root: `/home/jsutter/src/nixos`
|