Skip to content

Installation

AmazinAxel edited this page May 8, 2026 · 3 revisions

Install on a VM

If you don't want to commit to installing this flake on your actual hardware, it is possible to run this flake in a VM. I haven't tested this method so if it doesn't work then please let me know.

You need to first grab an iso. Either grab one from the Releases page (which is probably the easiest method) or build an iso yourself by cloning this repository and running nixos-rebuild build-image --image-variant iso --flake .#hostname (if you're installing it on an SD card for usage in a RPi, use an sd image variant: nixos-rebuild build-image --image-variant sd --flake .#hostname)

Then launch the VM there and clone this flake to /home/alec/Projects/flake/, then reboot.

Install on a new machine

The process is similar to the above, except you'll need to flash the iso to your drive of choice and boot from there. There's many tutorials available online, I recommend the Raspberry Pi Imager or just plain dd if you are on Linux.

Already running NixOS?

If you're already using NixOS, you can install the flake very easily. Note that your existing config will be replaced by this flake if you don't include its modules.

To install, just clone the repository and replace your hardware-configuration.nix file in any of the hosts (or make your own host) with your own. Then build it to boot (because using switch to install a practically entirely new system is very unsafe): sudo nixos-rebuild boot .#alecslaptop (but replace alecslaptop with whatever host you're inheriting or changing) then reboot your computer. By default the password is nixos, you should change it using passwd alec.

If the background is missing or you're encountering weird bugs, make sure you have cloned the repository specifically to /home/alec/Projects/flake/ since the wallpapers are hardlinked there.

This flake is a submission to Hack Club's Riceathon

Clone this wiki locally