❄️ NixOS configuration ❄️

⭐ Star us on GitHub — it motivates us a lot!

🚀 About

My personal NixOS configuration file.

It contains hardware/software configurations for setting up my personal/work machines.

[!IMPORTANT] As of this moment, I haven't yet reached the point of deploying VMs using Nix, meaning that this configuration IS INTENDED TO BE USED FOR PERSONAL USE ONLY.

Please don't try to copy-paste the configuration on your own machine and try to understand it first for the following reasons:

1. It simply won't work, due to the difference in hardware configuration between my machines and yours (for example gpu drivers, device IDs)
2. You won't learn much doing that, and later when you want to change something in your config it'll be harder for you to achieve that
3. This config structure is made by my personal taste, not yours ... and if some certain functionalities are either missing or badly implemented - then you would need to fork my repo and make your desired change in your version. Nevertheless, I'm more than open to suggestions for improvements, so please feel free to open an issue!

🏝️ Environment

🧪 Used Nix features

1. home-manager
2. flakes

🏗️ Structure

.
├── archive
├── assets
├── config.nix
├── flake.lock
├── flake.nix
├── flakes
├── home
├── hosts
├── LICENSE
├── Makefile
├── programs
├── README.md
├── TODO.md
└── wallpaper.jpg

• archive: not used in building the system. It stores the initial configuration of NixOS when first installed. (you can ignore this part)
• assets: used for storing media files, related to markdown documentation
• config.nix: An attribute set, containing all of the user and host specific configuration, that is consumed by the home and hosts module
• flake.lock: auto generated file, when building the system along with an argument of --flake. Used for pinning down the specific versions of the Nix dependencies, that are listed under flake.nix
• flake.nix: file for declaring all of the Nix specific dependencies/features (flake-parts, home-manager, nixpkgs, etc.). It is also the entry point for importing the user/system flakes
• flakes: used for storing all of the modularized flakes, that is consumed by flake-parts
• home: used for storing all the user environments (Joe's PC, Jane's PC, etc.)
• hosts: used for storing the hardware specifications of the hosts machines
• Makefile: automation script for aliasing Nix CLI commands in a more user-friendly way
• programs: contains the user/system type of packages
• wallpaper.jpg: background photo for i3wm

🧑‍💻 Commands

[!WARNING] Before starting to execute make commands, make sure to change the value of DEFAULT_USER to your preffered username, located in Makefile.

🌱 Setup

[!CAUTION] The hardware specific configuration is most likely not going to properly work on your system, so please make sure after you install my configuration and immediately change the bootloader and file system values (located at config.nix) with your appropriate values!

1. Work laptop

nixos-rebuild switch --flake github:iliyan-kostov9/nixos-config#hosts-work-laptop

2. Desktop PC

nixos-rebuild switch --flake github:iliyan-kostov9/nixos-config#hosts-personal-desktop

Afterwards enter config.nix and change the values of the file system and bootloader to the ones you currently have. You can also change the default username to your preferred one.

🤝 Acknowledgments

This configuration structure was inspired by contributions from the Nix community:

• wimpysworld
• ryan4yin
• simple-homemanager
• [chayward1] (https://github.com/chayward1/dotfiles)
• [notusknot] (https://github.com/notusknot/dotfiles-nix/tree/main)

🔍️ References

This section helped me better understand Nix package manager and Nix language. Please have a read on them!

📚 Docs

• Nixpills
• Nix and flakes
• Home manager manual
• Intro to Nix and NixOS

📄 Package and template links

• Nixpkgs
• MyNixOS
• NixOS cache
• Flake parts

🎨 Assets

• NixOS artwork

📃 License

This product is licensed under GNU General Public License