Added debugging boot problems blog article

1 files changed, 58 insertions, 0 deletions

diff --git a/content/blog/nix/debugging-boot-problems.md b/content/blog/nix/debugging-boot-problems.md
new file mode 100644
index 0000000..1a72ec8
--- /dev/null
+++ b/content/blog/nix/debugging-boot-problems.md
@@ -0,0 +1,58 @@
+---
+title: Recovering a nixos installation from a Linux rescue image
+description: How to chroot into a broken nixos system and fix it
+date: 2023-11-12
+tags:
+- nix
+---
+
+## Introduction
+
+This article explains how to chroot into a nixos system from a Linux rescue image. I recently had to do this while installing a nixos at ovh: I used an UEFI base image I prepared for oracle cloud instead of a legacy BIOS image. I could have just started the copy again using the right image, but it was an opportunity for learning and I took it.
+
+## Chrooting into a nixos system
+
+This works from any Linux system given you adjust the device paths. It will mount your nixos and chroot into it:
+```sh
+mount /dev/sdb2 /mnt/
+cd /mnt
+mount -R /dev dev
+mount -R /proc proc
+mount -R /sys sys
+mount /dev/sdb1 boot
+chroot ./ /nix/var/nix/profiles/system/activate
+chroot ./ /run/current-system/sw/bin/bash
+```
+
+A nixos system needs to have some runtime things populated under `/run` in order for it to work correctly, that is the reason for the profile activation step.
+
+## Generating a new hardware-configuration.nix
+
+Upon installation, a `/etc/nixos/hardware-configuration.nix` file is automatically created with specifics of your system. If you need to update it, know that its contents comes from the following command:
+```sh
+nixos-generate-config --show-hardware-config
+```
+
+## Building a new configuration
+
+Nixos has a configuration build sandbox that will not work from the chroot. To disable it I had to temporarily set the following in `/etc/nix/nix.conf`:
+```sh
+sandbox = false
+```
+
+Do not forget to reactivate it later!
+
+Next you will need to have a working DNS to make any meaningful change to a nixos configuration, because it will almost certainly need to download some new derivation. Since the `resolv.conf` is a symlink, you need to remove it before writing into it:
+```sh
+rm /etc/resolv.conf
+echo 'nameserver 1.1.1.1' > /etc/resolv.conf
+```
+
+You should now be able to rebuild your system to apply your configuration fix:
+```sh
+nixos-rebuild --install-bootloader boot
+```
+
+## Conclusion
+
+Nixos will not break often, and when it does you should be able to simply rollback from your boot loader menu. But if anything worse happens or if you are migrating a nixos installation to another chassis, or salving a hard drive... now you know how to proceed!