NixOS on ARM/Installation: Difference between revisions
m Add further plans |
Malteneuss (talk | contribs) m Add on-the-fly zstd decompression example |
||
Line 47: | Line 47: | ||
On the page click on the latest successful build to get a download link under build products. | On the page click on the latest successful build to get a download link under build products. | ||
=== Installation steps === | === Installation steps === | ||
Line 63: | Line 61: | ||
The base images are configured to boot up with a serial TTY ( RX/TX UART ) @ 115200 Baud. That way you not necessarily have to have a HDMI Display and keyboard. | The base images are configured to boot up with a serial TTY ( RX/TX UART ) @ 115200 Baud. That way you not necessarily have to have a HDMI Display and keyboard. | ||
Note: If the image has the extension <code>.zst</code>, it will need to be decompressed before writing to installation device. Use | |||
<code>nix-shell -p zstd --run "zstdcat image.img.zst | dd of=/dev/mmcblk0 status=progress"</code> | |||
to decompress the image on-the-fly. | |||
{{note| For some platforms, manually editing and adding kernel command-line arguments to <code>/boot/extlinux/extlinux.conf</code> may be needed for serial to work, and is "as" supported as would be editing the command-line manually during boot.}} | {{note| For some platforms, manually editing and adding kernel command-line arguments to <code>/boot/extlinux/extlinux.conf</code> may be needed for serial to work, and is "as" supported as would be editing the command-line manually during boot.}} | ||
Continue with [[NixOS_on_ARM/Initial_Configuration]]. | Continue with [[NixOS_on_ARM/Initial_Configuration]]. |
Revision as of 14:39, 9 May 2024
Installation
Getting the installer
UEFI iso
Continue to the UEFI page.
SD card images (SBCs and similar platforms)
For AArch64
it is possible to download images from Hydra.
On the page click on the latest successful build to get a download link under build products.
Installation steps
The .img files can be directly written to a microSD/SD card (minimal recommended size: 4 GB) using dd, once uncompressed from the ZSTD container. The SD card needs to be unmounted first.
Once the NixOS image file is downloaded, run the following command to install the image onto the SD Card, replace /dev/mmcblk0
with the path to the SD card (use dmesg
to find it out).
sudo dd if=nixos-sd-image-23.05pre482417.9c7cc804254-aarch64-linux.img of=/dev/mmcblk0
This should be enough to get you started, you may now boot your device for the first time.
The base images are configured to boot up with a serial TTY ( RX/TX UART ) @ 115200 Baud. That way you not necessarily have to have a HDMI Display and keyboard.
Note: If the image has the extension .zst
, it will need to be decompressed before writing to installation device. Use
nix-shell -p zstd --run "zstdcat image.img.zst | dd of=/dev/mmcblk0 status=progress"
to decompress the image on-the-fly.
Continue with NixOS_on_ARM/Initial_Configuration.