NixOS Artifacts

This project is experimental. Interfaces and option structures may change without notice.

NixOS Artifacts is a framework to unify artifacts and secrets in NixOS flakes. It provides a standardized interface for generation, rotation, and multi-backend storage.

Quick Start

New to nixos-artifacts? Start with Getting Started for a guided tutorial using agenix as the backend.

Documentation

What is NixOS Artifacts — Core concepts and architecture
Artifact definition example — How to define artifacts
Configure nixos-artifacts — Configuration and usage

Backend Development

Backend Quickstart — Create a working backend in minutes
Backend Concepts — Understand script execution flow
Backend Scripts Reference — Environment variables and examples

Reference

mkBackend — Create backend packages
mkArtifactCli — Create TUI packages
NixOS options — Full NixOS module options
Home Manager options — Home Manager module options