mirror of
https://github.com/NixOS/nix.dev.git
synced 2024-10-18 14:32:43 -04:00
42 lines
1.4 KiB
Markdown
42 lines
1.4 KiB
Markdown
|
# Building bootable ISO image
|
||
|
|
||
|
:::{note}
|
||
|
In case you'd like to build images for a different platform that you're on, see [Cross compiling](https://github.com/nix-community/nixos-generators#cross-compiling).
|
||
|
:::
|
||
|
|
||
|
Often we're faced with the official installation image lacking some hardware support.
|
||
|
|
||
|
Create `myimage.nix` that will point the kernel to the latest using the minimal installation iso:
|
||
|
|
||
|
```nix
|
||
|
{ pkgs, modulesPath, lib, ... }: {
|
||
|
imports = [
|
||
|
"${modulesPath}/installer/cd-dvd/installation-cd-minimal.nix"
|
||
|
];
|
||
|
|
||
|
# use the latest Linux kernel
|
||
|
boot.kernelPackages = pkgs.linuxPackages_latest;
|
||
|
|
||
|
# Needed for https://github.com/NixOS/nixpkgs/issues/58959
|
||
|
boot.supportedFilesystems = lib.mkForce [ "btrfs" "reiserfs" "vfat" "f2fs" "xfs" "ntfs" "cifs" ];
|
||
|
}
|
||
|
```
|
||
|
|
||
|
Generate an ISO with the above configuration:
|
||
|
|
||
|
```shell-session
|
||
|
$ NIX_PATH=nixpkgs=https://github.com/NixOS/nixpkgs/archive/74e2faf5965a12e8fa5cff799b1b19c6cd26b0e3.tar.gz nix-shell -p nixos-generators --run "nixos-generate --format iso --configuration ./myimage.nix -o result"
|
||
|
```
|
||
|
|
||
|
Copy the new image to your USB stick by replacing `sdX` with the name of your device:
|
||
|
|
||
|
```shell-session
|
||
|
$ dd if=result/iso/*.iso of=/dev/sdX status=progress
|
||
|
$ sync
|
||
|
```
|
||
|
|
||
|
## Next steps
|
||
|
|
||
|
- There are a bunch of [other formats that generators support](https://github.com/nix-community/nixos-generators#supported-formats),
|
||
|
for example different cloud providers or virtualization technologies
|