diff options
| author | Janneke Nieuwenhuizen <janneke@gnu.org> | 2024-11-25 16:17:33 +0100 |
|---|---|---|
| committer | Janneke Nieuwenhuizen <janneke@gnu.org> | 2024-12-03 08:26:03 +0100 |
| commit | 5cb84f2013c5b1e48a7d0e617032266f1e6059e2 (patch) | |
| tree | 86c752e8ca1ee8144c82afb7894cb5d90916cf98 /doc | |
| parent | 2c700af42cbb17859a7d80807fef2000cab7f8ad (diff) | |
system: Add "installer" sub-command.
* guix/scripts/system/installer.scm: New file.
* Makefile.am (MODULES)[ENABLE_INSTALLER]: Register it.
(MODULES_NOT_COMPILED)[!ENABLE_INSTALLER]: Likewise.
* guix/scripts/system.scm (show-help): Add help for "installer" sub-command.
(actions): Register "installer".
(guix-system): Invoke `guix-system-installer' sub-command.
* doc/guix.texi (Invoking guix system): Document it.
* gnu/installer.scm (run-installer): Remove "./pre-inst env".
Change-Id: I5a05b941c060682c17d45d871df3cf34e3f8643a
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/guix.texi | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index 8a6640124c..3278aeb7d6 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -43258,6 +43258,23 @@ This command also installs bootloader on the targets specified in @file{my-os-config}, unless the @option{--no-bootloader} option was passed. +@item installer +Run the installer. Usually the installer is built as an @file{iso} +image, copied to a USB Stick or DVD, and booted from (@ref{USB Stick and +DVD Installation}). If your machine already runs Guix and you still +want to run the installer, e.g., for testing purposes, you can skip the +step of creating an @file{iso} and run for instance: + +@example +guix system installer --dry-run +@end example + +@quotation Note +If you do not use @option{--dry-run} then you need to run as root. Be +@emph{very careful} when running the installer as root, it can cause +data loss or render your system unbootable! +@end quotation + @item vm @cindex virtual machine @cindex VM |