8.1 KiB
This is my NixOS config as a Nix flake eventually containing my (almost) complete setup from a desktop, to a server, to a personalized installer, almost everything. This configuration setup can be described with a list of features:
-
Deploy the same NixOS configuration for more than one system and in multiple output images. This is configured in
./configs/flake-parts/nixos.nixwhere not only you can deploy them with deploy-rs but build them as generated by nixos-generators. You can even configure what nixpkgs branch (and home-manager branch) it will use. -
Similarly, deploy the same home-manager configuration for more than one system. This time, it is configured with the ./configs/flake-parts/home-manager.nix file which you can configure what nixpkgs branch it will use.
-
Unify home-manager and NixOS configuration (and maybe other environments such as nix-darwin and system-manager in case I have use cases for those) into one flake.
-
Take full advantage of Nix module system with the cluster-wide custom modules [1]. This design bleeds into configuring the NixOS systems and home-manager users by designing host-specific modules and user-specific modules, respectively.
-
It has its own website. Which means that it’s cool (or over-the-top, whichever you prefer).
It’s basically my personal version of nixpkgs: a monorepo of everything I need for Nix-related things (unless it sprung into life as its own project).
Anyways, this project also has a dedicated website at {doc_site} which I recommend to take a gander on how this project structures its configuration (and much of the information is not covered in this README anyways).
If you want the local documentation and has angst against online documentation, you can view the source code of the book at ./docs/.
Getting started
This is an overencumbered set of NixOS configurations for different systems. For this section though, we’ll assume you’re only interested in installing the desktop configuration.
My main desktop configuration is quite big to the point where it cannot be completely installed with the regular installer from nixos.org without crashing. This is due to having not enough space given from the installer (being a 2GB tmpfs space which is enough for most) to build most of the outputs from the desktop derivation. For this, it now requires a modified persistent live installer (thus has a requirement of a larger disk space of >64GB).
A persistent live installer should only be intended to install the humungous configuration. It isn’t exactly made to be a NixOS-on-a-stick type but simply embiggening the root filesystem should be perfectly cromulent.
Once you have a live installer in boot, you can then simply install the following commands.
It will automate everything for you including the partitioning and mounting steps (powered by Disko).
NO ADDITIONAL mount COMMANDS NEEDED!
eval "$(nix build --no-link --print-out-paths github:foo-dogsquared/nixos-config#nixosConfigurations.ni-x86_64-linux.config.system.build.diskoScript)"
nixos-install --flake github:foo-dogsquared/nixos-config#ni-x86_64-linuxAnd voila! You should have my desktop configuration installed perfectly working (assuming no interruptions or crashes went while installing my desktop config).
However, it should also be barely usable since there are a couple of missing components that are needed such as the private keys for the desktop which is required for certain tasks such as backup task with Borg among other things.
Using the flake
If you want to use the flake as part of the flake inputs, you can simply include it in flake.nix.
{
inputs.foodogsquared-flake.url = "github:foo-dogsquared/nixos-config";
}For a better experience, I recommend using FlakeHub (with available instructions in the linked page). The FlakeHub flake follows a rolling release model so all of the releases are under 0.x.
Stability promise
If you’re one of the unfortunate users for whatever reason, sorry but there’s no stability promise here. Not every commit successfully builds because of the way how the project is managed (which is very very badly):
-
All of the included changes are pushed in one fell swoop over time instead of carefully testing each of them.
-
NixOS and home-manager configurations are able to be deployed in pure evaluation mode and suddenly it’s not (most of the time, it isn’t).
-
Module interfaces change all the time.
-
Packages can be left unmaintained and vanish at any time. [2]
This is my personal NixOS configuration, after all. It serves more of a platform to experiment with the Nix ecosystem rather than something that it’s meant to be used by others. There are some parts of the configuration that eventually sprung as its own project such as the Guix overlay (which eventually upstreamed into nixpkgs, hoorah!). Hopefully, more of them can be like that in the future (provided I still use Nix and have some time for it).
TODO
In order of priority:
-
✓ Create custom modules.
-
✓ Create a themes system similar to this NixOS config.
-
✓ Create a good workflow for creating ISOs.
-
✓ Create development shells.
-
✓ Manage secrets with agenix.
-
❏ Create a good workflow for tests.
-
✓ Automate backups with NixOS config.
-
✓ Create custom packages and export it to flakes. (Maybe consider making it to upstream)
-
✓ Create cluser-wide configs.
-
✓ Create host-wide configs.
-
✓ Create user-specific configs with home-manager.
-
✓ Steal Get some ideas from this overengineered template.
-
✓ Make use of other established utilities such as digga, flake-utils-plus, and home-manager once I’m familiar to create my own Nix programs.
Out of scope:
-
Set most program configurations with Nix. This is especially applicable to programs I always use such as my text editor configs.
-
The reason: managing them can be chaotic when applied with Nix. The potential for it is pretty nice especially when seen with similar implementations such as Guix home environment. However, I don’t want to rebuild it every time I change it.
-
-
Migration of my dotfiles. I still use it on other non-NixOS systems. Even on NixOS, yes.
-
To be a configuration framework. This is my personal configuration which means experimentation will always be here. Sudden changes can happen at any point.
Copyright
This project is licensed under MIT license.
I just chose it to make it easier to upstream parts of this project to nixpkgs and to make it easier to copy it without much problems (just don’t forget to add attribution as indicated from the license).
Please see ./LICENSE for the full text.