My NixOS Configurations

My current NixOS (and constant changing) configuration

Note: There are upcoming changes being actively made so documentation will change and may not necessarily be update to date!

Table of Contents

• Highlights
• References
• Structure
• Installation/Usage
• Tooling and Applications I Use
• Final Note

Highlights

• Multiple NixOS configurations, including laptop and desktop
• Install and partitioning commands via just
• Declarative partitioning with disko.
• Remote installation and configuration of NixOS hosts via nixos-anywhere.
• Flexible NixOS and Home Manager configs through importable feature flags
• Automatically append users to multiple hosts along with specific user settings for each user with a primary user and extra users
• Modular configuration, easily add new users and machines
• Wayland Setups
• Multiple fully featured desktop environments (KDE Plasma 6)
• Live image ISO build with Nvidia drivers, experimental nix features already enabled, unfree software usage, and some nice options for cli
• Declarative themes with stylix
• Deployment of secrets using sops-nix (with yubikey) via a private repository called nix-secrets
• Includes pre-commit scripts to make sure flake is correctly setup and ready for publication to a git repository
• Remote building with desktop configurations
• Built-in development shell via direnv

References

• Runarsf's dotfiles and imatpot's dotfiles - Custom library and inspiration for more traditional flake layout
• Llakala's nixos config - Additional libraries for home-manager cli integration and inspiration for integrating more HM stuff into the NixOS-specific configs
• Mistero77's nix-config and nix starter configs - Original inspiration for flake, opinionated settings, overlay/devshell setup, sops-nix setup, and better home-manager/nixos split layout
• Hlissner's dotfiles - Security hardening configs
• Baitinq's nixos-config - Partitioning scripts
• Theopn's and yutkat's dotfiles - Wezterm settings
• Getchoo's flake - Nvidia settings
• sagikazarmark's nix-config - Structure of host configurations
• archer-65's nix-dotfiles - Structure of host configurations
• lgug2z Handling Secrets in NixOS Blogpost - Git-crypt implementation for secrets required during flake evaluation
• Lillian-Violet's NixOS-Configuration - some ISO/live-image settings
• EmergentMind's nix-config and nix-secrets-reference - just file integration and helpful secret tips and nix-secrets + sops-nix deployment inspiration
• sickle-phin's dots-nix - Extra Nvidia environment variables

Structure

Here's an overview of the repository's file structure (Generated with eza --icons=never --tree):

./
├── checks/
├── config/
│   ├── core/
│   │   ├── chromium/
│   │   ├── firefox/
│   │   ├── git/
│   │   └── ...
│   ├── features/
│   │   ├── apps/
│   │   │   ├── browsers/
│   │   │   ├── editors/
│   │   │   ├── gaming/
│   │   │   ├── terminal/
│   │   │   └── ...
│   │   ├── boot/
│   │   ├── cli/
│   │   │   ├── behavior/
│   │   │   ├── development/
│   │   │   ├── multiplexer/
│   │   │   ├── oh-my-posh/
│   │   │   ├── shell/
│   │   │   └── ux/
│   │   ├── desktop/
│   │   ├── hardware/
│   │   ├── services/
│   │   │   ├── packaging/
│   │   │   └── ...
│   │   └── theme/
│   │       ├── catppuccin/
│   │       └── dracula/
│   └── roles/
│       └── home-pc/
│           ├── kde6/
│           ├── mail/
│           ├── role.nix
│           └── ...
├── extra/
│   ├── assets/
│   ├── documentation/
│   ├── homeModules/
│   ├── nixosModules/
│   └── scripts/
├── home/
│   ├── nixos/
│   │   └── main.nix
│   └── novaviper/
│       ├── dotfiles/
│       ├── main.nix
│       └── ssh.pub
├── hosts/
│   ├── framenova/
│   │   ├── config/
│   │   │   ├── disko.nix
│   │   │   └── ...
│   │   ├── hardware-configuration.nix
│   │   ├── main.nix
│   │   └── ssh_host_ed25519_key.pub
│   ├── installer/
│   │   ├── config/
│   │   ├── hardware-configuration.nix
│   │   └── main.nix
│   ├── knoxpc/
│   │   ├── config/
│   │   │   ├── services/
│   │   │   │   ├── homepage/
│   │   │   │   └── ...
│   │   │   ├── disko.nix
│   │   │   └── ...
│   │   ├── hardware-configuration.nix
│   │   ├── main.nix
│   │   └── ssh_host_ed25519_key.pub
│   └── ryzennova/
│       ├── config/
│       │   ├── disko.nix
│       │   └── ...
│       ├── hardware-configuration.nix
│       ├── main.nix
│       └── ssh_host_ed25519_key.pub
├── myLib/
├── overlays/
├── pkgs/
│   ├── load-resident-key/
│   ├── my-scripts/
│   │   ├── mutt-picker/
│   │   ├── status-battery/
│   │   ├── status-cpu-ram/
│   │   └── status-network/
│   └── ...
├── flake.lock
├── flake.nix
├── justfile
├── LICENSE
├── README.md
├── shell.nix
└── statix.toml

• flake.nix: Entrypoint for host and home configurations. Also exposes a devshell for boostrapping the system (nix develop or nix shell).
• myLib: Custom library functions for various parts of the flake, imported into HomeManager and NixOS
• hosts: Configurations for each machine, accessible via nixos-rebuild --flake.
  • framenova: Framework 13 - 32GB RAM, AMD Ryzen 7640U, AMD Radeon 760M | KDE Plasma 6
  • ryzennova: Primary PC - 32GB RAM, Ryzen 5600G, RTX 2060 6GB | KDE Plasma 6
  • knoxpc: NAS PC - 16GB RAM, Intel Core i5-8400, Intel UHD Graphics 630 | Headless
  • installer: ISO configuration | Nvidia drivers included | KDE Plasma 6
• home: Configurations for each user, includes both host OS specific (NixOS) and Home Manager configurations. Built together with the hosts configurations via nixos-rebuild --flake
• extra: Extra stuff like custom modules and flake documentation
  • nixosModules: Custom NixOS modules used throughout the flake (and some being upstreamable)
  • homeModules: Custom Home-Manager modules used throughout the flake (and some being upstreamable)
  • scripts: Bash/Posix scripts needed for various pre-commit and just commands
  • assets: Repository assets like images and videos
• config: Entrypoint for all configurations, contains the core and features folders for shared and opt-in configurations respectively. Also contains the roles folder for host-specific configurations.
  • core: Shared configurations applied to all hosts and users
  • features: Opt-in configurations/feature flags that one or more users/hosts can use
  • roles: System specific configurations for each host that is tagged with a specific role. These are used to share configurations between multiple hosts.
• checks: Flake evaluation tools for ensuring the flake is properly formatted and builds successfully. Also contains git-hooks to ensure the repository is properly setup. Accessible via nix flake check
• overlays: Patches and version overrides for some packages, applied to all systems and even the devshell. Accessible via nix build.
• pkgs: Custom nix packages defined similarly to the nixpkgs ones. Also accessible via nix build. You can compose these into your own configuration by using my flake’s overlay, or consume them through NUR.
• justfile: Command recipe file for just, contains various helpful commands for the flake
• shell.nix: Declaration of nix-shell, used for nix-shell and nix develop. Used for bootstrapping the system

Installation/Usage

For installation, check out the installation guide located under documentation/installation.md! Check out documentation/tips.md for some tips and important information regarding how the entire flake works.

Tooling and Applications I Use

Main user relevant apps

• kde plasma 6
• neovim
• fish + fzf + oh-my-posh
• firefox browser
• keepassxc
• vesktop
• sops-nix + gpg + ssh-agent + yubikey
• tailscale
• kdeconnect + localsend
• krita
• libreoffice
• ghostty + zelllij
• prusa-slicer
• and quite a bit more...

Nix stuff

• Home-Manager
• NixOS and nix, of course
• Nixos-anywhere

Final Note

I designed my NixOS flake to be modular and customizable; so feel free to change it up and use it in your own setups!