Skip to content

v1.0.0

Choose a tag to compare

@AmazinAxel AmazinAxel released this 20 Sep 18:19
· 485 commits to main since this release

Release 1.0.0

Completely stable & ready to use!

However, this must be built on your machine. To do so, follow these steps:

  • Install the Gnome NixOS ISO
  • Flash the ISO to any USB stick using Rufus or Balena Etcher
  • Insert the USB stick into your device
  • Power off your device

Then, boot from the USB stick that has the graphical NixOS installed

  • Turn on your device while repeatedly pressing Del, F11, F10, or F12 (this key depends on your device manufacturer - you need to boot into the BIOS or boot manager to launch from USB)
  • Select the USB drive to boot from
  • The computer will reboot into the graphical NixOS install
  • Connect to Wifi
    • (you will probably need to close the installer and open it again)
  • Fill out your details in the installation process but install using the CLI without a desktop for a faster build
  • Either:
    • Partition your drive to install alongside Windows (I recommend allocating half or more of storage) - even though it only uses like 20GB for the bare install
    • Wipe your entire drive and just daily drive NixOS - no Windows needed ;)
  • Once the installation is done, power off computer and remove the USB drive
  • Boot up computer using your BIOS key combination (same as earlier) and select the Linux/NixOS bootloader device to be first in the bootlist
  • Save and exit, boot into Linux, and you'll be greeted with a super scary TTY CLI >:)

Now, you're ready to install the Nix flake

  • Log in using your username/password set during the NixOS installation
  • Use nmtui and connect to your wifi
  • Use nix-shell -p git to temporarily install Git
  • Within the Git devshell, run git clone https://github.com/AmazinAxel/flake
    • I highly recommend cloning or moving this project into a folder like Projects/, by default this will be in your ~/
  • cd into the project: cd flake
  • Create a new host (use any one of my hosts as a base if you'd like)
  • Run nixos-generate-config and then run cp /etc/nixos/hardware-configuration.nix ./hosts/<device hostname here>/hardware-configuration.nix
    • The device hostname is what you want your device to be called - for example, mine could be alecpc or aleclaptop as they correlate to a hostname specified in the flake and hosts/ directory. You may rename one of mine.
    • If you don't follow this step, your system will be unbootable. Please do not build with my hardware configurations!
  • Run nixos-rebuild switch --flake .#your host here and wait for your system to build!
  • If your configured username is different than what was set in the NixOS installer, please set the password again using passwd <username> or you'll be locked out of your system!
  • Then, restart your system and have fun
    • (you'll have to reconnect to Wifi - but this time, use iwctl station wlan0 connect <network ssid>)