Dotfiles for new NixOS users.
Find a file
2026-02-12 15:37:58 -08:00
modules First commit! 2026-02-12 15:00:24 -08:00
scripts First commit! 2026-02-12 15:00:24 -08:00
.gitignore Emptying gitignore 2026-02-12 15:01:47 -08:00
configuration.nix First commit! 2026-02-12 15:00:24 -08:00
flake.nix First edit of readme 2026-02-12 15:28:13 -08:00
README.md asciing 2026-02-12 15:37:58 -08:00

# .▄▄▄  ▄• ▄▌▪   ▐ ▄ ▄▄▄▄▄▄▄▄ ..▄▄ · .▄▄ · ▄▄▄ . ▐ ▄  ▄▄· ▄▄▄ . #
# ▐▀•▀█ █▪██▌██ •█▌▐█•██  ▀▄.▀·▐█ ▀. ▐█ ▀. ▀▄.▀·•█▌▐█▐█ ▌▪▀▄.▀· #
# █▌·.█▌█▌▐█▌▐█·▐█▐▐▌ ▐█.▪▐▀▀▪▄▄▀▀▀█▄▄▀▀▀█▄▐▀▀▪▄▐█▐▐▌██ ▄▄▐▀▀▪▄ #
# ▐█▪▄█·▐█▄█▌▐█▌██▐█▌ ▐█▌·▐█▄▄▌▐█▄▪▐█▐█▄▪▐█▐█▄▄▌██▐█▌▐███▌▐█▄▄▌ #
# ·▀▀█.  ▀▀▀ ▀▀▀▀▀ █▪ ▀▀▀  ▀▀▀  ▀▀▀▀  ▀▀▀▀  ▀▀▀ ▀▀ █▪·▀▀▀  ▀▀▀  #
#################################################################```

hello there, stranger! quintessence is an opinionated flake-based config, built from the ground up for newer users, using KDE Plasma as desktop manager.

### feature list ###
-- stable-repo based, with a module for unstable packages.
-- easy environment variable management, from `flake.nix` and `modules/vars.nix`.
-- rebuild script and remote sync script.
-- fairly thorough comments throughout.

### getting started ###
begin with the NixOS graphical install medium. make sure to set the hostname and username as you'll want them, then reboot into that system.

open up `/etc/nixos/configuration.nix` in a text editor of your choice, then add `programs.git.enable = true;` right below the `time.timeZone` line. save out, then run `nixos-rebuild switch`. 

in a text editor of your choice, make some changes to the provided files.
-- in `flake.nix`, change the variables section as instructed.
-- if you set up disk encryption, copy your `boot.initrd.luks.devices` line from `/etc/nixos/configuration.nix` to `/home/USERNAME-GOES-HERE/dotfiles/configuration.nix`.