search

NixOS / nix.dev

Official documentation for getting things done with Nix.
https://nix.dev
Creative Commons Attribution Share Alike 4.0 International
2.36k stars 239 forks source link

Provisioning remote machines #1014

Open fricklerhandwerk opened 1 month ago

fricklerhandwerk commented 1 month ago

Starting with a NixOS server from scratch is still not well-covered by any documentation, and currently involves many manual steps.

Write a step-by-step tutorial where learners set up a basic deployment system to bootstrap remote machines with nixos-anywhere and disko. The documentation for both is lacking, but there is a short golden path if one knows it. Since a tutorial is supposed to teach a skill, it's more important to understand the process for arriving there than the result on its own.

nixos-discourse commented 1 month ago

This issue has been mentioned on NixOS Discourse. There might be relevant details there:

https://discourse.nixos.org/t/technical-writer-for-nix-documentation/48739/1