commit 4b0caba2c5d42f26bc9e199e97cb5023112f7f95 · pyrox.dev/nixpkgs

+43 -11

nixos/doc/manual/installation/installing-from-other-distro.section.md

···

       160
       160
        
           Refer to the `nixos-generate-config` step in

     

       161
       161
        
           [](#sec-installation) for more information.

     

       162
       162
        
       

     

       163
       163
       +
           ::: {.note}

     

       164
       164
       +
           On [UEFI](https://en.wikipedia.org/wiki/UEFI) systems, check that your `/etc/nixos/hardware-configuration.nix` did the right thing with the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition).

     

       165
       165
       +
           In NixOS, by default, both [systemd-boot](https://systemd.io/BOOT/) and [grub](https://www.gnu.org/software/grub/index.html) expect it to be mounted on `/boot`.

     

       166
       166
       +
           However, the configuration generator bases its [](#opt-fileSystems) configuration on the current mount points at the time it is run.

     

       167
       167
       +
           If the current system and NixOS's bootloader configuration don't agree on where the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition) is to be mounted, you'll need to manually alter the mount point in `hardware-configuration.nix` before building the system closure.

     

       168
       168
       +
           :::

     

       169
       169
       +
       

     

       170
       170
       +
           ::: {.note}

     

       171
       171
       +
           The lustrate process will not work if the [](#opt-boot.initrd.systemd.enable) option is set to `true`.

     

       172
       172
       +
           If you want to use this option, wait until after the first boot into the NixOS system to enable it and rebuild.

     

       173
       173
       +
           :::

     

       174
       174
       +
       

     

       163
       175
        
           You'll likely want to set a root password for your first boot using

     

       164
       176
        
           the configuration files because you won't have a chance to enter a

     

       165
       177
        
           password until after you reboot. You can initialize the root password

     
···

       231
       243
        
           $ echo etc/nixos | sudo tee -a /etc/NIXOS_LUSTRATE

     

       232
       244
        
           ```

     

       233
       245
        
       

     

       234
       234
       -
       1.  Finally, move the `/boot` directory of your current distribution out

     

       235
       235
       -
           of the way (the lustrate process will take care of the rest once you

     

       236
       236
       -
           reboot, but this one must be moved out now because NixOS needs to

     

       237
       237
       -
           install its own boot files:

     

       246
       246
       +
       1.  Finally, install NixOS's boot system, backing up the current boot system's files in the process.

     

       247
       247
       +
       

     

       248
       248
       +
           The details of this step can vary depending on the bootloader configuration in NixOS and the bootloader in use by the current system.

     

       249
       249
       +
       

     

       250
       250
       +
           The commands below should work for:

     

       251
       251
       +
       

     

       252
       252
       +
           - [BIOS](https://en.wikipedia.org/wiki/BIOS) systems.

     

       253
       253
       +
       

     

       254
       254
       +
           - [UEFI](https://en.wikipedia.org/wiki/UEFI) systems where both the current system and NixOS mount the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition) on `/boot`.

     

       255
       255
       +
             Both [systemd-boot](https://systemd.io/BOOT/) and [grub](https://www.gnu.org/software/grub/index.html) expect this by default in NixOS, but other distributions vary.

     

       238
       256
        
       

     

       239
       257
        
           ::: {.warning}

     

       240
       240
       -
           Once you complete this step, your current distribution will no

     

       241
       241
       -
           longer be bootable! If you didn't get all the NixOS configuration

     

       242
       242
       -
           right, especially those settings pertaining to boot loading and root

     

       243
       243
       -
           partition, NixOS may not be bootable either. Have a USB rescue

     

       244
       244
       -
           device ready in case this happens.

     

       258
       258
       +
           Once you complete this step, your current distribution will no longer be bootable!

     

       259
       259
       +
           If you didn't get all the NixOS configuration right, especially those settings pertaining to boot loading and root partition, NixOS may not be bootable either.

     

       260
       260
       +
           Have a USB rescue device ready in case this happens.

     

       261
       261
       +
           :::

     

       262
       262
       +
       

     

       263
       263
       +
           ::: {.warning}

     

       264
       264
       +
           On [UEFI](https://en.wikipedia.org/wiki/UEFI) systems, anything on the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition) will be removed by these commands, such as other coexisting OS's bootloaders.

     

       245
       265
        
           :::

     

       246
       266
        
       

     

       247
       267
        
           ```ShellSession

     

       248
       248
       -
           $ sudo mv -v /boot /boot.bak &&

     

       249
       249
       -
           sudo /nix/var/nix/profiles/system/bin/switch-to-configuration boot

     

       268
       268
       +
           $ sudo mkdir /boot.bak && sudo mv /boot/* /boot.bak &&

     

       269
       269
       +
           sudo NIXOS_INSTALL_BOOTLOADER=1 /nix/var/nix/profiles/system/bin/switch-to-configuration boot

     

       250
       270
        
           ```

     

       251
       271
        
       

     

       252
       272
        
           Cross your fingers, reboot, hopefully you should get a NixOS prompt!

     

       273
       273
       +
       

     

       274
       274
       +
           In other cases, most commonly where the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition) of the current system is instead mounted on `/boot/efi`, the goal is to:

     

       275
       275
       +
       

     

       276
       276
       +
           - Make sure `/boot` (and the [EFI System Partition](https://en.wikipedia.org/wiki/EFI_system_partition), if mounted elsewhere) are mounted how the NixOS configuration would mount them.

     

       277
       277
       +
       

     

       278
       278
       +
           - Clear them of files related to the current system, backing them up outside of `/boot`.

     

       279
       279
       +
             NixOS will move the backups into `/old-root` along with everything else when it first boots.

     

       280
       280
       +
       

     

       281
       281
       +
           - Instruct the NixOS closure built earlier to install its bootloader with:

     

       282
       282
       +
             ```ShellSession

     

       283
       283
       +
             sudo NIXOS_INSTALL_BOOTLOADER=1 /nix/var/nix/profiles/system/bin/switch-to-configuration boot

     

       284
       284
       +
             ```

     

       253
       285
        
       

     

       254
       286
        
       1.  If for some reason you want to revert to the old distribution,

     

       255
       287
        
           you'll need to boot on a USB rescue disk and do something along

+6 -4

nixos/modules/system/activation/switch-to-configuration.pl

···

       41
       41
        
       my $out = "@out@";

     

       42
       42
        
       # System closure path to switch to

     

       43
       43
        
       my $toplevel = "@toplevel@";

     

       44
       44
       -
       # Path to the directory containing systemd tools of the old system

     

       45
       45
       -
       my $cur_systemd = abs_path("/run/current-system/sw/bin");

     

       46
       46
       -
       # Path to the systemd store path of the new system

     

       47
       47
       -
       my $new_systemd = "@systemd@";

     

       48
       44
        
       

     

       49
       45
        
       # To be robust against interruption, record what units need to be started etc.

     

       50
       46
        
       # We read these files again every time this script starts to make sure we continue

     
···

       129
       125
        
       if ($action eq "boot") {

     

       130
       126
        
           exit(0);

     

       131
       127
        
       }

     

       128
       128
       +
       

     

       129
       129
       +
       # Path to the directory containing systemd tools of the old system

     

       130
       130
       +
       # Needs to be after the "boot" action exits, as this directory will not exist when doing a NIXOS_LUSTRATE install

     

       131
       131
       +
       my $cur_systemd = abs_path("/run/current-system/sw/bin");

     

       132
       132
       +
       # Path to the systemd store path of the new system

     

       133
       133
       +
       my $new_systemd = "@systemd@";

     

       132
       134
        
       

     

       133
       135
        
       # Check if we can activate the new configuration.

     

       134
       136
        
       my $cur_init_interface_version = read_file("/run/current-system/init-interface-version", err_mode => "quiet") // "";

+5 -4

pkgs/by-name/sw/switch-to-configuration-ng/src/src/main.rs

···

       997
       997
        
               std::env::set_var("LOCALE_ARCHIVE", locale_archive);

     

       998
       998
        
           }

     

       999
       999
        
       

     

       1000
       1000
       -
           let current_system_bin = std::path::PathBuf::from("/run/current-system/sw/bin")

     

       1001
       1001
       -
               .canonicalize()

     

       1002
       1002
       -
               .context("/run/current-system/sw/bin is missing")?;

     

       1003
       1003
       -
       

     

       1004
       1000
        
           let os_release = parse_os_release().context("Failed to parse os-release")?;

     

       1005
       1001
        
       

     

       1006
       1002
        
           let distro_id_re = Regex::new(format!("^\"?{}\"?$", distro_id).as_str())

     
···

       1071
       1067
        
           if *action == Action::Boot {

     

       1072
       1068
        
               std::process::exit(0);

     

       1073
       1069
        
           }

     

       1070
       1070
       +
       

     

       1071
       1071
       +
           // Needs to be after the "boot" action exits, as this directory will not exist when doing a NIXOS_LUSTRATE install

     

       1072
       1072
       +
           let current_system_bin = std::path::PathBuf::from("/run/current-system/sw/bin")

     

       1073
       1073
       +
               .canonicalize()

     

       1074
       1074
       +
               .context("/run/current-system/sw/bin is missing")?;

     

       1074
       1075
        
       

     

       1075
       1076
        
           let current_init_interface_version =

     

       1076
       1077
        
               std::fs::read_to_string("/run/current-system/init-interface-version").unwrap_or_default();