No description
- Nix 84.3%
- JavaScript 12.8%
- Lua 1.7%
- Shell 1.2%
NixOS Platform Repository
This repository defines host-level system behavior and bootstrap flow for the environment.
Purpose
- Build and switch NixOS hosts from a single flake.
- Provide reusable roles for desktop, server, and tooling concerns.
- Bootstrap the Kubernetes GitOps control plane on server hosts.
Start Here
- Main documentation index:
docs/README.md - Role system guide:
docs/ROLES.md - GitOps bootstrap and app flow:
docs/ARGOCD_APPS.md
Daily Use
- Make changes in this repository.
- Build the target host.
- Switch the target host.
- Verify system and cluster health.
Common commands:
nix flake check
nixos-rebuild build --flake .#<host>
sudo nixos-rebuild switch --flake .#<host>
Repository Scope
- This repo owns host OS, services, role composition, and cluster bootstrap.
- Runtime Kubernetes app manifests live in the sibling
kubernetesrepository.