foodogsquared/nixos-config
1
0
Fork 0
mirror of https://github.com/foo-dogsquared/nixos-config.git synced 2025-01-31 22:57:55 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
c2da083e5f
nixos-config/docs/website/content/en/02-lay-of-the-land/01-prerequisites/index.adoc
Gabriel Arazas c2da083e5f
docs: restructure folder 
Similar to wrapper-manager subproject, we're just preparing to make this
multi-output for our project's documentation.
2024-09-04 19:13:39 +08:00

2.4 KiB
Raw Blame History

title: Prerequisites --- = Prerequisites

Before you get into dive into this configuration, let’s establish a few things first. In order to make use of this system in the first place, you need the following components.

  • A NixOS installer image with flakes enabled. An example would be the unstable versions from NixOS project release page. As an additional option, you can also use my personalized NixOS installers which is primarily intended for me configs.

  • A flash drive or any storage device that will boot the installer image up for installation.

  • A computer with disabled secure boot. Because unfortunately, that’s the state of most Linux distros right now. [1] into usable and stable state.]

This primarily uses Nix flakes so you can have a preview of what’s available in my config.

nix flake show {canonical-flake-url}

All you have to do is to flash the installer image into the flash drive and boot with the drive (with the disabled secure boot).

Note

For this example, we’ll assume you’re installing my desktop configuration which is at nixosConfigurations.ni.

Next, we’ll partition the disk of the system. This is already handled for us since this project uses disko modules. Just run the following command as root.

nix run github:nix-community/disko -- --mode disko ./hosts/ni/disko.nix --arg disks '[ "/dev/nvme0n1" ]'

Then install the NixOS configuration (also as root).

nixos-install --flake {canonical-flake-url}#INSTALLABLE

Despite being a NixOS system, it isn’t entirely reproducible to the point of installing this config will work out-of-the-box. It has some things needed in the first place to work like my external backup setup where it needs my SSH private keys to work in the first place. You can see more details from What should not be here?. Nonetheless, the parts is it isn’t reproducible is only about 10% of this config. Everything else is fine and dandy and can be deployed successfully (but not used as intended).

1. But things change hopefully with github:nix-community/lanzaboote[Lanzaboote project