// index //

declarative GPU containers. vast.ai. runpod. bare-metal. zero dockerfile cope.

// start here //

• getting started — build your first container, ssh in
• options reference — all the knobs
• architecture — how it works internally
• services & runtime — Nimi, startup sequence
• defining custom services — add your own service modules
• secrets & agenix — keys never touch the nix store
• integrations — integrations with the nix ecosystem

// high-level //

1. declare containers under perSystem.nix2gpu.<n>
2. each container config is a nix module (like nixos modules)
3. nix2gpu assembles:
   • root filesystem with nix store + your packages
   • startup script for runtime environment
   • service graph via Nimi
4. helper commands:
   • nix build .#<n> — build image
   • nix run .#<n>.copy-to-container-runtime — load into docker/podman
   • nix run .#<n>.copy-to-github — push to ghcr
   • nix run .#<n>.copy-to-runpod — push to runpod

// cloud targets //

// where to go //

• just want something running → getting started
• want all the options → options reference
• hacking on internals → architecture
• secrets and tailscale → secrets