My dotfiles are not perfekt, but they strive to be:

• fully declarative 📝
• highly structured 🧱
• modular 🎛️
• a consistent look'n'feel ✨
• KISS (keep it stupid simple)🥴

This flake can and will radically change as I learn, discover new things and have new ideas.

• 👥 Multiple hosts
• 🧍 Standalone home
• ❄️🏗️ Snowfall-lib structure
• ❄️ almost every module can be disabled
• ❄️💲 Snowfall-flake commands
• 📦 Declarative flatpaks

1. Install NixOS and enable the (experimental) nix feature flakes.

2. Dotfiles preparation (mandatory changes to my dotfiles):

   1. git clone https://github.com/dafitt/dotfiles.git.

   2. cd dotfiles.

   3. Read and understand my dotfiles' structure and code.

   4. Add a (your) new system-configuration to /systems/<architecture>/<host>/default.nix. Available dafitt-nixos options can be found at templates/system/default.nix.

   5. Copy and import hardware-configuration.nix.

   6. Set the correct current system.stateVersion.

   7. Add a (your) new home-configuration to homes/<architecture>/<user>[@<host>]/default.nix Available dafitt-home options can be found at templates/home/default.nix.

   8. Commit all changes:

      git add . && git commit -m "systems: added <host>"
      

   9. Uncomment nixConfig in flake.nix and enter nix develop on your first build for faster build time.

3. Build:

   1. Enter nix-shell and then nix develop .#default
   2. sudo nixos-rebuild boot --flake .#<host>
   3. Check for home-manager errors with systemctl status home-manager-<user>.service and resolve them if necessary
   • NOTE: First install may take some time; especially with flatpaks enabled.

4. reboot.

5. Personal imperative setup:

   1. Configure monitor setup with nwg-displays
   2. Syncthing setup
   3. firefox: Sync Login
      1. NoScript
      2. 1Password
      3. Sidebery
   4. pavucontrol: Set standard audio output

1. Install nix and enable the (experimental) nix feature flakes.

2. Dotfiles preparation (mandatory changes to my dotfiles):

   1. git clone https://github.com/dafitt/dotfiles.git.

   2. cd dotfiles.

   3. Read and understand my dotfiles' structure and code.

   4. Set the correct current system.stateVersion.

   5. Add a (your) new home-configuration to homes/<architecture>/<user>[@<host>]/default.nix Available dafitt-home options can be found at templates/home/default.nix.

   6. Commit all changes:

      git add . && git commit -m "homes: added <user>[@<host>]"
      

   7. Uncomment nixConfig in flake.nix and enter nix develop on your first build for faster build time.

3. System Requirements (Installation depending on your Distribution):

   • dafitt.flatpak.enable: Flatpak
   • dafitt.hyprland.enable: Hyprland, UWSM
   • dafitt.gnome.enable: GNOME

4. Build:

   1. Enter nix develop .#default's shell. Alternative: nix run home-manager -- --flake .#<user>[@<host>] switch.
   2. home-manager --flake .#<user>[@<host>] switch.
   3. Check for home-manager errors with systemctl status home-manager-<user>.service and resolve them if necessary.
   • NOTE: First install may take some time; especially with flatpaks enabled.

• NüschtOS option search
• NixOS packages search
• Nix functions
• Nix functions
• Noogle

To use nixpkgs stable branch, update the following inputs to the latest release (25.05 as an example) in flake.nix and rebuild the system.
ATTENTION! When the latest release of nixpkgs is some time away, then you will likely need to refactor some breaking changed options. See the backward incompatibilities in the release notes for those. Directly after a new release should be the best time to switch.

{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-25.05";
    unstable.url = "github:nixos/nixpkgs/nixos-unstable";
    home-manager = { url = "github:nix-community/home-manager/release-25.05"; inputs.nixpkgs.follows = "nixpkgs"; };
    stylix.url = "github:danth/stylix/release-25.05";
  };
}

To still let specific packages follow nixpkgs unstable while on the stable branch you can add a overlays/unstable/default.nix:

{ channels, ... }:

final: prev:
with channels.unstable; {
  # packages to get from inputs.unstable
  inherit
    gamescope
    lutris
    vscodium
    ;
}

You can try using my modules through importing them:

# flake.nix
inputs = {
  dafitt = { url = "github:dafitt/dotfiles"; inputs.nixpkgs.follows = "nixpkgs"; };
};

outputs = { nixpkgs, ... }@inputs: {
  nixosConfigurations."<host>" = nixpkgs.lib.nixosSystem {
    system = "x86_64-linux";
    modules = [
      # e.g.
      inputs.dafitt.nixosModules."gnome"
      inputs.dafitt.nixosModules."bootloader/systemd"
      inputs.dafitt.homeManagerModules."stylix"
      inputs.dafitt.homeManagerModules."firefox"
    ];
  };
};

But it is certainly better to simply copy them into your dotfiles and adapt them to your needs.

What you have to customize:

• modules/nixos/time/default.nix: timezone
• modules/nixos/locale/default.nix: locale
• modules/home/firefox/default.nix:
  • the default searx search engine is my own local instance/server, use a official one or setup your own
  • custom firefox plugins
• systems/<architecure>/<host>/default.nix: your own host-configuration
  • hardware-configuration.nix
  • maybe some host-specific configuration.nix: make sure to import it: imports = [ ./configuration.nix ];
• homes/<architecure>/<user>[@<host>]/default.nix: your own user with your home-configuration

Optionally:

• modules/home/desktops/hyprland/default.nix: familiar keybindings
• modules/home/stylix/default.nix: custom base16 theme / icon theme
• Packages and programs you need

Some basic flake commands

nix-shell shell.nix # only when on legacy-nix: enables flakes & git (works only locally)

nix develop github:dafitt/dotfiles#default

nix flake show github:dafitt/dotfiles

NixOS & Home-manager:

nixos-rebuild switch --flake .#[<host>]

Home-manager standalone:

home-manager switch --flake .#[<user>@<host>]

nix flake update --commit-lock-file

# specific input
nix flake lock --update-input [input]

NixOS: sudo nixos-rebuild switch --rollback

Home-manager standalone: see Home-manager documentation

nix fmt [./folder] [./file.nix]

SUPER_CONTROL - System and Hyprland control
SUPER - Window control
SUPER_ALT - Applications
SHIFT - reverse, grab, move

I use snowfall-lib, so every default.nix is automatically imported.

My systems and homes are assembled using custom modules config.dafitt.<myModule>. Any custom module has at least one enable option config.dafitt.<myModule>.enable which name matches the folder modules/<nixos|home>/<myModule>/.

Modules in modules/nixos/ are built with the standard nixos-rebuild command.

Modules in modules/home/ are built with home-manager (standalone) and in addition to nixos-rebuild if the homes-hostname "<user>[@<host>]" matches with the host your building on. This is done by snowfall-lib with the systemd-service home-manager-<user>.service. snowfall-lib will create the user if it doesn't exist yet.

Some home-modules in my dotfiles are automatically activated, if the twin module in nixos-modules is enabled. See this line in modules/home/suiteGaming/default.nix for example:

options.dafitt.suiteGaming.enable = mkBoolOpt (osConfig.dafitt.suiteGaming.enable or false) "...

The special attribute set osConfig which contains all the nixos-configuration is only present when building with nixos-rebuild.

Check if your option is being set through osCfg. Like this:

enable = mkBoolOpt (osCfg.enable or config.dafitt.suiteGaming.enable) "Whether to enable steam.";

If that is the case and osCfg.enable is not null then the osCfg-option will be preferred. Even if it is false.

To solve this set your option to true in modules/nixos/ or systems/.

Manually reload the fontconfig cache using

fc-cache -r [-f]

rfkill list
sudo rfkill unblock bluetooth

• "Using Nix on non-NixOS distros, it's common to see GL application errors" - NixGL:

  nix run --impure github:nix-community/nixGL -- <PROGRAM>

• Try to also install the program with the underlining distro. E.g. Debian:

  sudo apt install <PROGRAM>

• Vimjoyer - Youtube
• IogaMaster - Youtube
• mikeroyal/NixOS-Guide
• jakehamilton/config
• IogaMaster/dotfiles
• IogaMaster/snowfall-starter
• Misterio77/nix-config
• Aylur/dotfiles