❄️ NixOS Config

Welcome to my NixOS configuration, you can find the repo here.

✨ Features

• 🖥️ Multiple Hosts Support: Easy to configure for different hosts.
• 🪟 Hyprland + Waybar: Highly configurable window compositor on Wayland.
• 🏠 Home Manager Integration: Manage user-specific configurations with ease.
• 🐚 Zsh + Starship: Efficient shell setup with lots of aliases.
• 👻 Ghostty: Fast and feature-rich terminal emulator.
• ✍️ Neovim: The best editor.
• 🔑 YubiKey Login: Fast and secure authentication with YubiKeys.

📝 Notes

• I’ve chosen to tightly integrate Home Manager and NixOS within the same file and directory structure, rather than separating them into different files and folders. This keeps the configuration more cohesive but comes with some important caveats:
  • Home Manager options must always be written inside a:

    home-manager.users.${user} = {
      ...
    };
    

    block within your configuration files.
  • Home Manager attributes cannot be imported at the top level (outside of the home-manager.users.<user> block). For example:

    { pkgs, user, ... }:
    {
      home-manager.users.${user} = { config, ... }: {
        programs.rofi = {
          ...
          theme = let
            inherit (config.lib.formats.rasi) mkLiteral;
          in {
            ...
          };
        };
      };
    }
    

    Here, note that config is only available within the home-manager.users.<user> block—trying to import Home Manager attributes directly at the top level will fail.
• This design choice reduces duplication and keeps related configurations together, but it requires extra attention to module scoping and to distinguishing between NixOS and Home Manager settings.
• If you prefer a more typical separated configuration structure (e.g. fully declarative Home Manager setup using home.nix per host), check out Andrey0189’s NixOS Config Reborn, which this repository was briefly based on before the latest refactor.

🚀 Installation

To get started with this setup, follow these steps:

1. Install NixOS If you haven’t already installed NixOS, follow the NixOS Installation Guide for detailed instructions.

2. Clone the Repository

   git clone https://github.com/jonwin1/nixos-jonwin
   cd nixos-jonwin
   

3. Copy one of the host configurations to set up your own

   cp -r config/desktop config/<your_hostname>
   

4. Put your hardware-configuration.nix file there

   cp /etc/nixos/hardware-configuration.nix nixos/<your_hostname>/
   

5. Edit the configuration files as needed See File Structure below for an overview of where to find what. You might for example what to set you git name and email or change the name and logo on the hyprlock screen.

6. Add a YubiKey or disable the module See NixOS Wiki - YubiKey PAM U2F or remove the module from config/common/modules.nix.

7. Edit the flake.nix file

   ...
   let
     hosts = [
   --  {
   --    user = "jonwin";
   --    hostname = "desktop";
   --    system = "x86_64-linux";
   --  }
   --  {
   --    user = "jonwin";
   --    hostname = "laptop";
   --    system = "x86_64-linux";
   --  }
   ++  {
   ++    user = "<your_username>";
   ++    hostname = "<your_hostname>";
   ++    system = "x86_64-linux";
   ++  }
     ];
   ...
   

8. Rebuild

   git add .
   sudo nixos-rebuild switch --flake .#<hostname>
   # or, if you're installing on a fresh system:
   sudo nixos-install --flake .#<hostname>
   

9. Wallpaper Add a file ~/Pictures/wallpaper.png to set the wallpaper.

📂 File Structure

📂 .
┣ ❄️ flake.nix (Main entry point for the NixOS flake)
┣ 📂 config/ (Host and shared configuration files)
┃ ┣ 📂 common/ (Shared settings for all hosts)
┃ ┃ ┣ ❄️ configuration.nix (Shared config options)
┃ ┃ ┣ ❄️ modules.nix (Shared module imports)
┃ ┃ ┗ ❄️ packages.nix (Shared packages)
┃ ┗ 📂 <hostname>/ (Settings for a specific machine)
┃   ┣ ❄️ configuration.nix (Host-specific config options)
┃   ┣ ❄️ hardware-configuration.nix (Hardware configuration for this host)
┃   ┣ ❄️ modules.nix (Host-specific module imports)
┃   ┗ ❄️ packages.nix (Host-specific packages)
┗ 📂 modules/ (Reusable custom modules)
  ┗ … (e.g. window manager, shell, applications)

🤝 Contributions

Feel free to fork the repository and submit pull requests if you’d like to contribute improvements. Open issues if you encounter any problems with the config or have ideas for new features.

📜 License

This project is licensed under the GPL-3.0 License. See the LICENSE file for details.