From a53596cb47dac766f196f3571aa8b9a6a693c456 Mon Sep 17 00:00:00 2001 From: Valentin Gagarin Date: Tue, 30 Jan 2024 23:13:45 +0100 Subject: [PATCH] NixOS VM tutorial: add next steps --- .../tutorials/module-system/module-system.md | 1 + .../nixos/building-bootable-iso-image.md | 1 + .../nixos/nixos-configuration-on-vm.md | 19 +++++++++++++------ 3 files changed, 15 insertions(+), 6 deletions(-) diff --git a/source/tutorials/module-system/module-system.md b/source/tutorials/module-system/module-system.md index 45c88ed3d..f0c306323 100644 --- a/source/tutorials/module-system/module-system.md +++ b/source/tutorials/module-system/module-system.md @@ -1,3 +1,4 @@ +(module-system-deep-dive)= # Module system deep dive Or: *Wrapping the world in modules* diff --git a/source/tutorials/nixos/building-bootable-iso-image.md b/source/tutorials/nixos/building-bootable-iso-image.md index fd030cfe8..0a56d4f17 100644 --- a/source/tutorials/nixos/building-bootable-iso-image.md +++ b/source/tutorials/nixos/building-bootable-iso-image.md @@ -1,3 +1,4 @@ +(bootable-iso-image)= # Building a bootable ISO image :::{note} diff --git a/source/tutorials/nixos/nixos-configuration-on-vm.md b/source/tutorials/nixos/nixos-configuration-on-vm.md index 406a9f9fb..c72113c18 100644 --- a/source/tutorials/nixos/nixos-configuration-on-vm.md +++ b/source/tutorials/nixos/nixos-configuration-on-vm.md @@ -6,20 +6,21 @@ One of the most important features of NixOS is the ability to configure the enti NixOS configurations can be used to test and use NixOS using a virtual machine, independent of an installation on a "bare metal" computer. -:::{important} -A NixOS configuration is a Nix language function following the [NixOS module](https://nixos.org/manual/nixos/stable/index.html#sec-writing-modules) convention. -::: - ## What will you learn? This tutorial serves as an introduction creating NixOS virtual machines. -Virtual machines are a practical tool for debugging NixOS configurations. +Virtual machines are a practical tool for experimenting with or debugging NixOS configurations. ## What do you need? - A working [Nix installation](https://nix.dev/manual/nix/2.18/installation/installation.html) on Linux, or [NixOS](https://nixos.org/manual/nixos/stable/index.html#sec-installation), with a graphical environment - Basic knowledge of the [Nix language](reading-nix-language) +:::{important} +A NixOS configuration is a Nix language function following the [NixOS module](https://nixos.org/manual/nixos/stable/index.html#sec-writing-modules) convention. +For a thorough treatment of the module system, check the [](module-system-deep-dive) tutorial. +::: + ## Starting from a default NixOS configuration In this tutorial you will use a default configuration that is shipped with NixOS. @@ -95,7 +96,7 @@ The default NixOS configuration without comments is: } ``` -To be able to log in add the following lines to the returned attribute set: +To be able to log in, add the following lines to the returned attribute set: ```nix users.users.alice = { @@ -242,3 +243,9 @@ rm nixos.qcow2 - [Nix manual: `nix-build`](https://nix.dev/manual/nix/2.18/command-ref/nix-build.html). - [Nix manual: common command-line options](https://nix.dev/manual/nix/2.18/command-ref/opt-common.html). - [Nix manual: `NIX_PATH` environment variable](https://nix.dev/manual/nix/2.18/command-ref/env-common.html#env-NIX_PATH). + +## Next steps + +- [](module-system-deep-dive) +- [](integration-testing-vms) +- [](bootable-iso-image)