aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
diff options
context:
space:
mode:
authorJustus Perlwitz <hello@justus.pw>2024-07-20 21:42:56 +0900
committerJustus Perlwitz <hello@justus.pw>2024-07-20 22:03:12 +0900
commit2ca7dbb5b0c7b50d2bc049b9c8fb0ef076e641ab (patch)
treed8a818252f07087b6c75d00f6f2bcc226bf29f42 /README.md
parentMerge pull request #450 from motiejus/nixos-24.05 (diff)
downloadYubiKey-Guide-2ca7dbb5b0c7b50d2bc049b9c8fb0ef076e641ab.tar.gz
Document how to test NixOS build with QEMU
Diffstat (limited to 'README.md')
-rw-r--r--README.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/README.md b/README.md
index 57d9584..5e28bb7 100644
--- a/README.md
+++ b/README.md
@@ -225,6 +225,19 @@ sudo cp -v result/iso/yubikeyLive.iso /dev/sdc ; sync
Skip steps to create a temporary working directory and a hardened configuration, as they are already part of the image.
+If you want to test your build before copying it into a USB stick, you can try it out on your machine using a tool like QEMU.
+Please keep in mind that a virtualized environment does not provide the same amount of security as an ephemeral system (see *Prepare environment* above).
+Here is an example QEMU invocation after placing `yubikeyLive` in `result/iso` using the above `nix build` command:
+
+```console
+# Launch with 4G memory, 2 CPUs and KVM enabled
+qemu-system-x86_64 \
+ -enable-kvm \
+ -m 4G \
+ -smp 2 \
+ -drive readonly=on,media=cdrom,format=raw,file=result/iso/yubikeyLive.iso
+```
+
**Arch**
```console