Skip to content
vanixiets

vanixiets

Multi-machine nix infrastructure for nixos, nix-darwin, and home-manager using aspect-based deferred module composition and clan fleet coordination.
Getting started View on GitHub

Features

Section titled “Features”

Aspect-based module organization

Every nix file is a deferred flake-parts module organized by feature category rather than by host. Cross-cutting configuration via unified modules spans nixos, nix-darwin, and home-manager.

Clan deployment

Multi-machine coordination with unified deployment across N machines (4 darwin, 4 nixos). Service orchestration via clan inventory system with role-based assignments.

Per-package nixpkgs channel selection

Multi-channel overlay architecture enables unstable default with selective stable fallbacks. Apply surgical fixes for broken packages without requiring full flake lockfile rollback.

Cross-platform deployment targets

Deploy to nixos, nix-darwin, or home-manager configurations. Consistent architecture across linux and macos systems with platform-specific modules.

Declarative secrets management

Clan vars manages encrypted secrets (SSH keys, zerotier identities, API tokens). Uses sops encryption internally with automatic generation and deployment.

Composable package overlays

Multi-layer overlay composition: simultaneously use multiple upstream nixpkgs channels, apply stable fallbacks, and define custom packages and overrides. Integrates a flake-parts-compatible pkgs-by-name pattern for custom package definitions.

Infrastructure as code

Terranix modules support deployment to multiple cloud providers including Hetzner, GCP, AWS, Azure infrastructure provisioning. Togglable compute nodes for cost-controlled cloud resource usage.

Quick start

Section titled “Quick start”
Terminal window
# Clone repository
git clone https://github.com/cameronraysmith/vanixiets.git
cd vanixiets


# Bootstrap nix and essential tools
make bootstrap && exec $SHELL


# Activate direnv
direnv allow


# Activate configuration
just activate

See Getting started guide for complete setup instructions.

Architecture

Section titled “Architecture”

Multi-layer architecture combining complementary patterns:

  1. flake-parts - Modular flake composition framework enabling deferred module integration
  2. Aspect-based organization - Feature-oriented module structure with import-tree auto-discovery
  3. clan - Multi-machine coordination and deployment
  4. Multi-channel nixpkgs - Per-package nixpkgs channel selection for stable fallbacks

Learn more in Architecture overview.

Documentation structure

Section titled “Documentation structure”
  • Guides - Task-oriented how-tos for common operations
  • Concepts - Understanding-oriented explanations of architecture and patterns
  • Reference - Information-oriented lookup material
  • Development - AMDiRE-based development documentation

Next steps

Section titled “Next steps”

Understand the architecture

Deferred module composition + clan architecture for multi-machine deployments. Architecture overview →

Understand clan integration

Multi-machine coordination, deployment, and service orchestration. Clan Integration →