Products · Product
NixOS
Raised as a usability problem by 203 people on Hacker News over 14 years (2013–2026), in 129 threads.
No issue was raised by at least 3 people in 3 threads this year.
- 1
- 2
- 3
- 4
- 5
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
Every issue, all time, most people first
Hard to troubleshoot unexpected behaviour and find how to do thingsUnreviewed
20132026- Official docs are hard to find and search engines skip them2026-03-23
- Troubleshooting is a nightmare due to unhelpful error messages and poor documentation2026-02-01
- Requires a long, effortful learning curve before the system becomes manageable2025-06-01
Upgrading a complex config to a new release takes half an hourUnreviewed
20132026- Spending a week getting a program to build; configuration takes more time than projects2026-04-20
- Upgrading a complex config to a new release takes half an hour of focused effort2025-12-24
- Declarative config is annoying and slow when iterating to get something working2024-05-25
Nix's DSL is obscure and harder to learn than SchemeUnreviewed
20132026- Nix configuration DSL is hard to write and understand, implementation feels backwards2026-03-01
- Configuration is a programming language, so adding a package is a chore needing a dedicated team2023-12-15
- Documentation and configuration language are hard to understand for newcomers2023-07-10
Suggested Python packaging approach failed, Nix language hard to followUnreviewed
20132026- Installing a package missing from the repo is onerous, requiring custom Nix packaging and detective work2024-12-26
- Suggested Python packaging approach didn't work; Nix language hard to follow when writing packages2020-06-03
- Nix language too weird; hard to work out how to install Python and Ruby libraries2019-04-23
Standard install instructions fail, forcing digging under the hoodUnreviewed
20132026- Many tools won't install easily and need an FHS workaround2024-01-09
- When needed info or packages aren't documented or available, finding a way to install software is hard2022-10-05
- Simple install method is undocumented, so users searching for common install processes find nothing2022-01-24
Running downloaded binaries needs guessing library paths, fixes often failUnreviewed
20132026- Running downloaded binaries requires guessing the right library paths, and fixes often fail2022-02-19
- Downloaded scripts and prebuilt binaries break because they expect standard system paths2022-01-24
- Config language is weird and third-party binaries fail due to non-standard directory structure2020-11-08
Installer forces a separate volume for /nix, confusing setupUnreviewed
20132026- Setting up NixOS on a VPS requires manual partitioning, losing repeatability gains2023-08-13
- Confusing whether NixOS is an OS, since install page shows shell script instead2021-10-10
- Initial setup is confusing because installer must create a separate volume for /nix2020-11-08
Docs don't match install lacking flakes, confusing flake.nix and default.nixUnreviewed
20132026- Nixos-install does not work with flake submodules, causing headaches2025-01-17
- Hard to know which tool to use (nix shell, flakes, nix-env) and how they fit together2023-07-10
- Standard install lacks flakes, and docs don't match, causing confusion about flake.nix vs default.nix2021-06-02
Custom packages feel like arcane incantations even for simple thingsUnreviewed
20132026- Creating custom packages feels like arcane incantations even for simple things2024-07-25
- Unclear documentation makes it hard to run a custom binary or write a package2019-10-23
- Constantly had to write own packages and found it too confusing2016-08-08
New users get no guidance on configuring after installUnreviewed
20132026- Configuration is so complicated that new users struggle and can easily break their system2026-09-25
- Users can't easily find packages, config options, or how to switch without a browser or handbook2025-01-18
- After installing, new users get no guidance on configuring the system and must dig through manuals2023-11-03
Unreviewed issues were grouped by machine: Claude Haiku labelled each comment as a usability complaint, named what it's about and summed up the problem in a line, and a small model grouped similar problems. Nobody has checked them by hand. Expect mistakes.
The newest 50 complaints
- Arcane syntax, confusing defaults and inscrutable docs that skip basic concepts2026-10-20
- Configuration is so complicated that new users struggle and can easily break their system2026-09-25
- Finds working with NixOS annoying; the Nix language is ugly and feels unnecessarily required2026-09-25
- Can't configure a Wi-Fi setting alongside NetworkManager; workaround requires runtime tooling and socket setup2026-08-25
- Nix syntax is hard to learn; updates repeatedly break and need manual fixing2026-07-24
- Took six hours to find how to create a directory; docs poor2026-06-15
- Spending a week getting a program to build; configuration takes more time than projects2026-04-20
- Official docs are hard to find and search engines skip them2026-03-23
- Docs and forum threads are hard for beginners to follow, making the first month a steep climb2026-03-23
- Too many competing ways to install software, so no single clear path2026-03-23
- The unusual filesystem layout causes most of the user's Nix issues and gives little benefit2026-03-23
- Unclear whether to install a package or service, and minimal installs lack expected apps2026-03-23
- Documentation is hard to find or lacking, making features like mkOutOfStoreSymlink difficult to learn2026-03-23
- Gave a USB error on first boot, so the user abandoned the install2026-03-22
- Apps that write their own config files need custom Nix modules and activation scripts to configure2026-03-22
- Components randomly stop working after reboot, and recovery from a broken update is hard on Arch2026-03-11
- Nix configuration DSL is hard to write and understand, implementation feels backwards2026-03-01
- Troubleshooting is a nightmare due to unhelpful error messages and poor documentation2026-02-01
- Keyboard-centric configuration is frustrating on a touch-centric handheld; simple settings like timezone are needlessly hard2026-01-02
- Upgrading a complex config to a new release takes half an hour of focused effort2025-12-24
- Removing a GNOME extension left native functionality unusable because a preference was not reverted2025-12-23
- Documentation is very poor and there is no single set of best practices2025-12-01
- Module system is a second language on top of Nix, hard to write correctly2025-11-30
- Beginner docs are scarce; searches surface advanced transmission-rebuild-level material instead2025-11-30
- Requires manual intervention before upgrades, cryptic errors, and confusing or outdated docs2025-11-30
- Steep learning curve, especially for packages not in nixpkgs2025-08-04
- Every software setting must be learned in NixOS form, and testing config changes requires rebuild switches2025-08-04
- Docs recommend imperative channel commands over the declarative approach, adding confusion2025-07-19
- Module system is a second language with no editor assistance or LSP support2025-06-02
- Manual installation process is painful, and it's hard to know if setups will work2025-06-01
- Requires a long, effortful learning curve before the system becomes manageable2025-06-01
- Package conflicts are hard to resolve, with no online info on fixing them2025-06-01
- Declarative install needs much setup effort, hard to justify for one-off installs2025-06-01
- Getting a newer Flutter version working needed hours of flake authoring2025-05-17
- Upgrades broke from incompatible configs, forcing reliance on Nix docs over project docs2025-05-17
- Forgets how to set up gpg pin-entry and must search for it each time2025-05-17
- Ordinary user tasks like changing shell or SSH keys require contacting the administrator2025-05-17
- Learning curve is prohibitive for beginners; poor docs and Flakes/Home Manager layers make failures hard to diagnose2025-05-17
- KDE and GNOME desktops are severely lacking in user experience design2025-03-11
- Users can't easily find packages, config options, or how to switch without a browser or handbook2025-01-18
- Nixos-install does not work with flake submodules, causing headaches2025-01-17
- Network settings placed where the template implies, but that is misleading; broken config blocks self-repair2025-01-15
- Too many ways to do the same thing; docs lag behind deprecated features2025-01-15
- Wayland support for KDE Plasma 6 was undocumented in the installer and hard to find2025-01-15
- Updating systemd sometimes drops the network connection during nixos-rebuild switch2025-01-14
- Steep learning curve and documentation often less than ideal for newcomers2025-01-14
- Builds sometimes fail and need repeated runs, with errors that mysteriously resolve themselves2025-01-14
- Error messages and documentation don't lead to a fix; searching the error gets nowhere2025-01-12
- Downloaded random executables from the internet don't work out of the box2025-01-11
- Using and installing software on NixOS with existing tools is confusing and horrible2024-12-30