NixOS Infrastructure Framework
Reusable, environment-agnostic components for building and managing NixOS-based infrastructure.
Contents
| Directory | Purpose |
|---|---|
modules/ |
NixOS modules (machine types, services, users) |
lib/ |
Nix utility functions |
pkgs/ |
Custom packages not in Nixpkgs |
overlays/ |
Nixpkgs overlays |
scripts/ |
Operational scripts (deploy, create LXC, etc.) |
environments/ |
Example environments to get started |
Getting Started
- Clone this repository.
- Create your own environment directory (see
environments/sample/). - Reference framework modules via relative paths or
fetchGit. - Add your host configurations, network layout, and secrets.
Creating Your Own Environment
environments/your-env/
├── configuration.nix # Environment entry point
├── hosts/
│ ├── servers/
│ │ └── myhost/
│ │ └── configuration.nix
│ └── workstations/
├── network/ # Subnets, VLANs, host assignments
├── secrets/ # agenix-encrypted secrets
└── users/ # User configurations
License
See LICENSE.