nixos-and-flakes-book/docs/introduction/advantages-and-disadvantages.md

Advantages & Disadvantages of NixOS

Advantages of NixOS

• Declarative Configuration, OS as Code
  • NixOS uses declarative configuration to manage the entire system environment. These configurations can be managed directly with Git, allowing the system to be restored to any historical state as long as the configuration files are preserved (provided the desired states are declared in the Nix configuration).
  • Nix Flakes further enhance reproducibility by utilizing a flake.lock version lock file, which records the data source addresses, hash values, and other relevant information for all dependencies. This design greatly improves Nix's reproducibility and ensures consistent build results. It draws inspiration from package management designs in programming languages like Cargo and npm.
• Highly Convenient System Customization Capability
  • With just a few configuration changes, various components of the system can be easily replaced. Nix encapsulates all the underlying complex operations within Nix packages, providing users with a concise set of declarative parameters.
  • Modifications are safe and switching between different desktop environments (such as GNOME, KDE, i3, and sway) is straightforward, with minimal pitfalls.
• Rollback Capability
  • It is possible to roll back to any previous system state, and NixOS even includes all old versions in the boot options by default, ensuring the ability to easily revert changes. Consequently, Nix is regarded as one of the most stable package management approaches.
• No Dependency Conflict Issues
  • Each software package in Nix has a unique hash, which is incorporated into its installation path, allowing multiple versions to coexist.
• The community is active, with a diverse range of third-party projects
  • The official package repository, nixpkgs, has numerous contributors, and many people share their Nix configurations. Exploring the NixOS ecosystem is an exciting experience, akin to discovering a new continent.

All historical versions are listed in the boot options of NixOS.
Image from NixOS Discourse - 10074

Disadvantages of NixOS

• High Learning Curve:
  • Achieving complete reproducibility and avoiding pitfalls associated with improper usage requires learning about Nix's entire design and managing the system declaratively, rather than blindly using commands like nix-env -i (similar to apt-get install).
• Disorganized Documentation:
  • Currently, Nix Flakes remains an experimental feature, and there is limited documentation specifically focused on it. Most Nix community documentation primarily covers the older nix-env/nix-channel approach. If you want to start learning directly from Nix Flakes, you need to refer to a significant amount of outdated documentation and extract the relevant information. Additionally, some core features of Nix, such as imports and the Nix Module System, lack detailed official documentation, requiring resorting to source code analysis.
• Increased Disk Space Usage:
  • To ensure the ability to roll back the system at any time, Nix retains all historical environments by default, resulting in increased disk space usage.
  • While this additional space usage may not be a concern on desktop computers, it can become problematic on resource-constrained cloud servers.
• Obscure Error Messages:
  • In general, error messages are usually clear. However, in some cases, the error messages may not provide specific reasons, and using --show-trace can produce a lengthy internal stack trace, making it time-consuming to identify the root cause.
  • Two potential reasons for this problem are: (1) Nix is a dynamically-typed language, and various parameters are determined at runtime, and (2) error handling logic in the used flake packages may be inadequate, resulting in unclear error messages. Some obscure errors may not even be traceable through error stacks.
• More Complex Underlying Implementation:
  • Nix's declarative abstraction introduces additional complexity in the underlying code compared to similar code in traditional imperative tools.
  • This complexity increases implementation difficulty and makes it more challenging to make custom modifications at the lower level. However, this burden primarily falls on Nix package maintainers, as regular users have limited exposure to the underlying complexities, reducing their burden.

Summary

Overall, I believe that NixOS is suitable for developers with a certain level of Linux usage experience and programming knowledge who desire greater control over their systems.

I do not recommend newcomers without any Linux usage experience to dive directly into NixOS, as it may lead to a frustrating journey.

If you have more questions about NixOS, you can refer to the last chapter of this book, FAQ.