From ca65b5535001d388ee134d6926e3ea1f408d2ace Mon Sep 17 00:00:00 2001 From: phaer Date: Mon, 14 Apr 2025 10:00:35 +0200 Subject: [PATCH] manual: explain per-variant customizations for build-image --- ...ng-images-via-nixos-rebuild-build-image.chapter.md | 11 +++++++++++ nixos/doc/manual/redirects.json | 3 +++ 2 files changed, 14 insertions(+) diff --git a/nixos/doc/manual/installation/building-images-via-nixos-rebuild-build-image.chapter.md b/nixos/doc/manual/installation/building-images-via-nixos-rebuild-build-image.chapter.md index 378b1163a6e3..20c9d93b1377 100644 --- a/nixos/doc/manual/installation/building-images-via-nixos-rebuild-build-image.chapter.md +++ b/nixos/doc/manual/installation/building-images-via-nixos-rebuild-build-image.chapter.md @@ -14,3 +14,14 @@ nixos-image-amazon-25.05pre-git-x86_64-linux.vhd nix-support To get a list of all variants available, run `nixos-rebuild build-image` without arguments. +## Customize specific image variants {#sec-image-nixos-rebuild-build-image-customize} + +The `image.modules` option can be used to set specific options per image variant, in a similar fashion as [specialisations](options.html#opt-specialisation) for generic nixos configurations. + +E.g. images for the cloud provider Linode use `grub2` as a bootloader by default. If you are using `systemd-boot` on other platforms and want to disable it for Linode onlz, you could use the following options: + +``` nix + image.modules.linode = { + boot.loader.systemd-boot.enable = lib.mkForce false; + }; +``` diff --git a/nixos/doc/manual/redirects.json b/nixos/doc/manual/redirects.json index 313610aa0b07..21e335be6870 100644 --- a/nixos/doc/manual/redirects.json +++ b/nixos/doc/manual/redirects.json @@ -200,6 +200,9 @@ "sec-image-nixos-rebuild-build-image": [ "index.html#sec-image-nixos-rebuild-build-image" ], + "sec-image-nixos-rebuild-build-image-customize": [ + "index.html#sec-image-nixos-rebuild-build-image-customize" + ], "sec-image-repart": [ "index.html#sec-image-repart" ],