about summary refs log tree commit diff
path: root/nixpkgs/nixos/doc/manual/installation/installing-kexec.section.md
blob: 61d8e8e5999b94d194481b43675412e38399e373 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
# "Booting" into NixOS via kexec {#sec-booting-via-kexec}

In some cases, your system might already be booted into/preinstalled with
another Linux distribution, and booting NixOS by attaching an installation
image is quite a manual process.

This is particularly useful for (cloud) providers where you can't boot a custom
image, but get some Debian or Ubuntu installation.

In these cases, it might be easier to use `kexec` to "jump into NixOS" from the
running system, which only assumes `bash` and `kexec` to be installed on the
machine.

Note that kexec may not work correctly on some hardware, as devices are not
fully re-initialized in the process. In practice, this however is rarely the
case.

To build the necessary files from your current version of nixpkgs,
you can run:

```ShellSession
nix-build -A kexec.x86_64-linux '<nixpkgs/nixos/release.nix>'
```

This will create a `result` directory containing the following:
 - `bzImage` (the Linux kernel)
 - `initrd` (the initrd file)
 - `kexec-boot` (a shellscript invoking `kexec`)

These three files are meant to be copied over to the other already running
Linux Distribution.

Note its symlinks pointing elsewhere, so `cd` in, and use
`scp * root@$destination` to copy it over, rather than rsync.

Once you finished copying, execute `kexec-boot` *on the destination*, and after
some seconds, the machine should be booting into an (ephemeral) NixOS
installation medium.

In case you want to describe your own system closure to kexec into, instead of
the default installer image, you can build your own `configuration.nix`:

```nix
{ modulesPath, ... }: {
  imports = [
    (modulesPath + "/installer/netboot/netboot-minimal.nix")
  ];

  services.openssh.enable = true;
  users.users.root.openssh.authorizedKeys.keys = [
    "my-ssh-pubkey"
  ];
}
```


```ShellSession
nix-build '<nixpkgs/nixos>' \
  --arg configuration ./configuration.nix
  --attr config.system.build.kexecTree
```

Make sure your `configuration.nix` does still import `netboot-minimal.nix` (or
`netboot-base.nix`).