nixos-ops

Manage multi-host NixOS configurations with flakes and Just commands.

21|Updated Jan 5, 2024
One-click install
npx skills add https://github.com/olafkfreund/nixos_config --skill nixos-ops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nixos-ops
Source: https://github.com/olafkfreund/nixos_config/tree/main/.gemini/skills/nixos-ops
Command: npx skills add https://github.com/olafkfreund/nixos_config --skill nixos-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill clarifies and coordinates the architecture, deployment workflows, and tooling for a unified multi-host NixOS repository, enabling consistent configurations, predictable deployments, and faster iteration across hosts.

Core Features & Use Cases

  • Unified multi-host flake architecture: central inputs and outputs with standardized host creation.
  • Host-level customization: makeNixosSystem usage, overlays, and Home Manager integration for each host (p620, razer, p510, samsung).
  • Deployment & testing workflows: Justfile, nix tooling, and automated validation patterns to ensure reliable rollouts.
  • Use Case: A user adds a new host template and verifies the configuration across all hosts with a single workflow.

Quick Start

Install and explore the repository, then run the Just-based validation and deployment commands on a local or target host:

  • just check-syntax
  • just validate
  • just deploy

Frequently Asked Questions about nixos-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage multi-host NixOS configurations from a single repository?

You can manage multi-host NixOS configurations by using a unified flake architecture with centralized inputs and outputs, standardized host creation via makeNixosSystem, and Home Manager integration for consistent per-host setups.

What is the best way to automate NixOS deployment and testing across multiple machines?

Automating NixOS deployment across multiple machines is best handled through Justfile commands and nix tooling, allowing you to run automated validation patterns like just check-syntax and just validate before executing just deploy.

How do flakes and overlays work together for NixOS host provisioning?

Flakes and overlays work together in NixOS host provisioning by centralizing flake inputs and applying custom package overlays through the makeNixosSystem function, ensuring standardized and predictable host construction across different machines.

Can I integrate Home Manager into a unified NixOS flake workflow?

Yes, you can integrate Home Manager into a unified NixOS flake workflow by configuring it within the makeNixosSystem construction, allowing per-host user environment management alongside your system configuration.

Do I need Just to run NixOS validation and deployment workflows?

You need Just to execute the predefined validation and deployment workflows in this setup, as it provides the command runner for tasks like just check-syntax, just validate, and just deploy to ensure reliable rollouts.

Why use a centralized NixOS flake for managing multiple hosts instead of separate configurations?

Using a centralized NixOS flake for multiple hosts enables consistent configurations, predictable deployments, and faster iteration by coordinating architecture definition and tooling integration across all machines from a single source.