pyrox.dev
lol
nixos/docs: add non-switchable-systems section
+22
+21
nixos/doc/manual/development/non-switchable-systems.section.md
+21
nixos/doc/manual/development/non-switchable-systems.section.md
···
1
+
# Non Switchable Systems {#sec-non-switchable-system}
2
+
3
+
In certain systems, most notably image based appliances, updates are handled
4
+
outside the system. This means that you do not need to rebuild your
5
+
configuration on the system itself anymore.
6
+
7
+
If you want to build such a system, you can use the `image-based-appliance`
8
+
profile:
9
+
10
+
```nix
11
+
{ modulesPath, ... }: {
12
+
imports = [ "${modulesPath}/profiles/image-based-appliance.nix" ]
13
+
}
14
+
```
15
+
16
+
The most notable deviation of this profile from a standard NixOS configuration
17
+
is that after building it, you cannot switch *to* the configuration anymore.
18
+
The profile sets `config.system.switch.enable = false;`, which excludes
19
+
`switch-to-configuration`, the central script called by `nixos-rebuild`, from
20
+
your system. Removing this script makes the image lighter and slightly more
21
+
secure.