skill-add-nixos-host

Bootstrap a NixOS host in the serenitea-pot flake by generating default.nix and system.nix and registering host key.

14|3|Updated Jul 23, 2023
One-click install
npx skills add https://github.com/codgician/serenitea-pot --skill skill-add-nixos-host
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-add-nixos-host
Source: https://github.com/codgician/serenitea-pot/tree/main/.opencode/skills/skill-add-nixos-host
Command: npx skills add https://github.com/codgician/serenitea-pot --skill skill-add-nixos-host

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines the process of adding a new NixOS host to the serenitea-pot flake, reducing manual setup and configuration drift.

Core Features & Use Cases

  • Provides a standardized host directory structure under hosts/nixos/<hostname>.
  • Generates and configures default.nix and system.nix for a new machine, enabling quick bootstrapping with your flake.
  • Guides secure host enrollment by registering the host key and validating configurations before deployment.
  • Use cases include adding bare-metal, VM, container, or WSL hosts and bootstrapping their NixOS systems.

Quick Start

Create a new host directory under hosts/nixos/<hostname>, generate default.nix and system.nix, and register the host key to bootstrap the NixOS machine.

Frequently Asked Questions about skill-add-nixos-host

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

FAQPage Schema
How do I bootstrap a new NixOS host within a nix flake?

To bootstrap a new NixOS host, you create a host directory under hosts/nixos/<hostname>, generate default.nix and system.nix templates, and register the host key to validate configurations before deployment.

Can I use this Skill to add a NixOS host in WSL or a container?

Yes, this Skill supports adding new NixOS machines across bare-metal, VM, container, and WSL scenarios. It generates the necessary system.nix templates to enable quick bootstrapping for each environment.

What is the required directory structure for NixOS host management?

NixOS host management requires a flake-based setup using hosts/nixos/<hostname> directories. Each directory must contain default.nix and system.nix templates to properly configure the new machine.

Do I need a registered host key to deploy a NixOS configuration?

Yes, a registered host key is required to securely enroll the machine and validate configurations before deployment. This key enables the flake to deploy the NixOS system confidently without configuration drift.

Why does adding a new NixOS machine manually cause configuration drift?

Manual setup causes configuration drift because it lacks standardized directory structures and templates. This Skill streamlines the process by generating default.nix and system.nix files to maintain consistency across hosts.