Overview

This repository contains a collection of NixOS configurations, modules, and tools designed to make system management more efficient. The goal is to make wiring easy and deployment straight forward.

Features

• 🏗️ Flake-based configuration management
• 🔐 Secrets management with sops-nix
• 🚀 Deployment tools with deploy-rs
• 🔍 Package search with nix-index-database
• 🌐 Remote installation support with nixos-anywhere

Prerequisites

• Nix with flakes enabled
• direnv
• just

Quick Start

1. Enter the development shell: only needed if missing direnv

   just dev
   

2. Update dependencies:

   just update
   

3. Check the configuration:

   just check
   

Directory Structure

.
├── configurations/     # System configurations
│   └── nixos/        # NixOS system configurations
├── modules/          # Reusable NixOS and flake modules
│   ├── flake/       # Flake-specific modules
│   └── nixos/       # NixOS modules
├── overlays/         # Custom package overlays
├── packages/         # Custom packages
├── flake.nix        # Main flake configuration
├── flake.lock       # Flake lock file
└── justfile         # Common commands

Available Commands

The repository includes several convenient commands via just:

• just - List all available commands
• just update - Update nix flake dependencies
• just lint - Lint nix files
• just check - Check nix flake
• just dev - Enter development shell
• just run - Activate the configuration

Configuration

System Configuration

System configurations are located in configurations/nixos/. Each system should have its own directory with the following structure:

configurations/nixos/<system-name>/
├── default.nix    # Main system configuration
├── hardware.nix        # Hardware-specific configuration
└── secrets/           # Encrypted secrets (if using sops-nix)

Development

Adding New Modules

1. Create a new module in modules/nixos/ or modules/flake/
2. Update the flake.nix to include the new module
3. Test the module with just check

Adding New Packages

1. Create a new package in packages/<name>/default.nix
2. Update the flake.nix to include the new package
3. Test the package with just check

Acknowledgments

• NixOS
• deploy-rs
• sops-nix
• disko