Tutorials overview

This tracking issue is an outline of tutorials we want to present on nix.dev, originally designed in the 2023 documentation project "Learning Journey". It is continuously updated as we better understand how beginners approach the Nix ecosystem.

Please check existing tutorial requests before submitting new proposals.

Outline

• Temporary environments
  • Ad hoc shell environments
  • Reproducible interpreted scripts
  • Declarative shell environments
    • https://github.com/NixOS/nix.dev/issues/516
• Nix language basics
• Customisable packages
  • https://github.com/NixOS/nix.dev/issues/116
  • Packaging existing software
  • https://github.com/NixOS/nix.dev/issues/603
  • https://github.com/NixOS/nix.dev/issues/651
  • Working with local files
  • Debugging builds
• https://github.com/NixOS/nix.dev/issues/579
• Declarative configurations
  • Module system basics
  • https://github.com/NixOS/nix.dev/issues/129
  • Editor configuration with Home Manager (Neovim, Emacs, VS Code)
  • Declarative macOS configuration (with nix-darwin)
  • Declarative Linux configuration (with system-manager)
  • NixOS in a virtual machine
  • https://github.com/NixOS/nix.dev/issues/738
  • NixOS on a Raspberry Pi
• Module system deep dive
• Build, test, and deploy software
  • #1012
  • #1013
  • Cross compilation
  • Integration testing with NixOS virtual machines
  • #1014
  • Continuous integration with GitHub Actions
  • Remote NixOS installation (with nixos-anywhere)
  • Build and run NixOS containers
  • Build and run Docker images
  • Deploy NixOS using Terraform

Other tasks:

• https://github.com/NixOS/nix.dev/issues/750
• https://github.com/NixOS/nix.dev/issues/845

How you can help

• Tell us what's important to you, by adding 👍 on issues for tutorials that you would like to get addressed.
• If you find helpful, freely licensed tutorials, open an issue

support the Nix documentation team on Open Collective to help

Start with the linked 2023 documentation project and review the existing tutorial issues referenced in the outline. This is a tracking issue rather than a self-contained task; completion would require a defined tutorial proposal or implementation and updating the outline when that work is finished.