to deploy:

nixos-rebuild --flake ".#servo" {build,switch}

if the target is the same as the host, nix will grab the hostname automatically:

nixos-rebuild --flake . {build,switch}

more options (like building packages defined in this repo):

nix flake show

secrets

i use sops for secrets. see hosts/common/secrets.nix for some tips.

building images

to build a distributable image (GPT-formatted image with rootfs and /boot partition):

nix build ./#imgs.lappy

this can then be dd'd onto a disk and directly booted from a EFI system. there's some post-processing to do before running a rebuild on the deployed system (deploying ssh keys, optionally changing fs UUIDs, etc). refer to flake.nix for more details.

building packages

build anything with

nix build .#<pkgname>

specifically, i pass the full package closure to the legacyPackages flake output. that includes both my own packages and upstream packages.

on the other hand the packages output contains only my own packages.

in addition, my packages are placed into both the global scope and a sane scope. so use the scoped path when you want to be explicit.

nix build sane.linux-megous

using this repo in your own config

this should be a pretty "standard" flake. just reference it, and import either

• nixosModules.sane (for the modules)
• overlays.pkgs (for the packages)

nixosModules.sane corresponds to everything in the modules/ directory. it's a mix of broad and narrow scope options. e.g. sane.fs is a completely standalone thing, whereas sane.web-browser is highly personalized and doesn't really make sense to export. regardless of scope, i do try to ensure that everything in modules/ is hidden behind some enable flag so that the disorganization isn't that critical.

contact

if you want to contact me for questions, or collaborate to split something useful into a shared repo, etc, you can reach me via any method listed here.