# Documentation

**URL:** https://discourse.nixos.org/c/dev/documentation/25.md

[Latest](https://discourse.nixos.org/latest.md) · [Categories](https://discourse.nixos.org/categories.md)

---

## [About the Documentation category](https://discourse.nixos.org/t/about-the-documentation-category/4547)

<div class="topic-metadata">

**Author:** [@zimbatm](https://discourse.nixos.org/u/zimbatm)\
**Replies:** 0

</div>

This is the place where we talk about documentation. The goal is to improve reference and learning material. Here you can also get in touch with the Nix documentation team.

---

## [2026-10-28 Documentation team meeting notes](https://discourse.nixos.org/t/2026-10-28-documentation-team-meeting-notes/80842)

<div class="topic-metadata">

**Author:** [@hsjobeki](https://discourse.nixos.org/u/hsjobeki)\
**Replies:** 3\
**Last updated:** [October 29, 2026, 4:45pm UTC](https://discourse.nixos.org/t/2026-10-28-documentation-team-meeting-notes/80842 "2026-10-29T16:45:29Z")

</div>

Meeting info Past meeting notes Documentation office hours in the NixOS Calendar Attendees: @friedow @hsjobeki @trespaul @sheeeng Notes by: automated transcription (experiment) vision doc: nix.dev/maintainers/vision.md…

---

## [Localization of The Nix Reference Manual](https://discourse.nixos.org/t/localization-of-the-nix-reference-manual/80562)

<div class="topic-metadata">

**Author:** [@hwhsu1231](https://discourse.nixos.org/u/hwhsu1231)\
**Replies:** 15\
**Last updated:** [October 26, 2026, 6:56am UTC](https://discourse.nixos.org/t/localization-of-the-nix-reference-manual/80562 "2026-10-26T06:56:01Z")

</div>

Hello NixOS Community, I’m the founder of the Localize the Docs organization, and I’m glad to announce that the :tada: nix-ref-man-l10n :tada: project is now published: :rocket: Preview: nix-ref-man-l10n …

---

## [2026-10-14 Documentation team meeting notes](https://discourse.nixos.org/t/2026-10-14-documentation-team-meeting-notes/80573)

<div class="topic-metadata">

**Author:** [@hsjobeki](https://discourse.nixos.org/u/hsjobeki)\
**Replies:** 2\
**Last updated:** [October 16, 2026, 9:56am UTC](https://discourse.nixos.org/t/2026-10-14-documentation-team-meeting-notes/80573 "2026-10-16T09:56:29Z")

</div>

Meeting info Past meeting notes Documentation office hours in the NixOS Calendar Attendees: @trespaul @hsjobeki @paotsaq @friedow Notes by: @friedow vision doc: nix.dev/maintainers/vision.md at master · NixOS/nix.dev ·…

---

## [Documentation needs to be created towards agents](https://discourse.nixos.org/t/documentation-needs-to-be-created-towards-agents/80179)

<div class="topic-metadata">

**Author:** [@olafkfreund](https://discourse.nixos.org/u/olafkfreund)\
**Replies:** 59\
**Last updated:** [October 16, 2026, 5:56pm UTC](https://discourse.nixos.org/t/documentation-needs-to-be-created-towards-agents/80179 "2026-10-16T17:56:47Z")

</div>

I know that what I’m about to say will be unpopular here. I think documentation needs to be created towards agents more and more. Users will are using agents to gather information these days, llms.txt will be the hear a…

---

## [2026-09-30 Documentation team meeting notes](https://discourse.nixos.org/t/2026-09-30-documentation-team-meeting-notes/80374)

<div class="topic-metadata">

**Author:** [@hsjobeki](https://discourse.nixos.org/u/hsjobeki)\
**Replies:** 6\
**Last updated:** [October 1, 2026, 4:19pm UTC](https://discourse.nixos.org/t/2026-09-30-documentation-team-meeting-notes/80374 "2026-10-01T16:19:05Z")

</div>

Meeting info Past meeting notes Documentation office hours in the NixOS Calendar Attendees: @trespaul @hsjobeki @hartan @MattSturgeon @paotsaq @riotbib Notes by: everyone vision doc: nix.dev/maintainers/vision.md at ma…

---

## [NixOs and Nix skill for LLM's](https://discourse.nixos.org/t/nixos-and-nix-skill-for-llms/80199)

<div class="topic-metadata">

**Author:** [@olafkfreund](https://discourse.nixos.org/u/olafkfreund)\
**Replies:** 5\
**Last updated:** [September 30, 2026, 1:02pm UTC](https://discourse.nixos.org/t/nixos-and-nix-skill-for-llms/80199 "2026-09-30T13:02:58Z")

</div>

Portable skills for AI coding agents, maintained from pinned upstream sources. Notice!! This has been create with help of Claude,Codex and Antigravity agents with full human review. Skill Purpose Initial reference …

---

## [2026-08-19 Documentation team meeting notes](https://discourse.nixos.org/t/2026-08-19-documentation-team-meeting-notes/79672)

<div class="topic-metadata">

**Author:** [@hsjobeki](https://discourse.nixos.org/u/hsjobeki)\
**Replies:** 0\
**Last updated:** [August 21, 2026, 8:22am UTC](https://discourse.nixos.org/t/2026-08-19-documentation-team-meeting-notes/79672 "2026-08-21T08:22:58Z")

</div>

Meeting info Past meeting notes Documentation office hours in the NixOS Calendar Attendees: @trespaul @hsjobeki @friedow Notes by: everyone vision doc: nix.dev/maintainers/vision.md at master · NixOS/nix.dev · GitHub S…

---

## [2026-08-05 Documentation team meeting notes](https://discourse.nixos.org/t/2026-08-05-documentation-team-meeting-notes/79372)

<div class="topic-metadata">

**Author:** [@hsjobeki](https://discourse.nixos.org/u/hsjobeki)\
**Replies:** 1\
**Last updated:** [August 8, 2026, 3:52pm UTC](https://discourse.nixos.org/t/2026-08-05-documentation-team-meeting-notes/79372 "2026-08-08T15:52:26Z")

</div>

Meeting info Past meeting notes Documentation office hours in the NixOS Calendar Attendees: @hsjobeki @trespaul @friedow @samestep Notes by: everyone vision doc: nix.dev/maintainers/vision.md at master · NixOS/nix.dev …

---

## [What's the replacement for NIXOS\_LUSTRATE?](https://discourse.nixos.org/t/whats-the-replacement-for-nixos-lustrate/78824)

<div class="topic-metadata">

**Author:** [@QuBe](https://discourse.nixos.org/u/QuBe)\
**Replies:** 13\
**Last updated:** [July 21, 2026, 3:40pm UTC](https://discourse.nixos.org/t/whats-the-replacement-for-nixos-lustrate/78824 "2026-07-21T15:40:46Z")

</div>

Reading Installing from another Linux distribution (from nixos manual) step 9 says: The lustrate process will not work if the boot.initrd.systemd.enable option is set to true, which is now the default. Setting this to f…

---

## [2026-07-08-documentation-team-meeting-notes](https://discourse.nixos.org/t/2026-07-08-documentation-team-meeting-notes/78838)

<div class="topic-metadata">

**Author:** [@hsjobeki](https://discourse.nixos.org/u/hsjobeki)\
**Replies:** 3\
**Last updated:** [July 12, 2026, 2:55pm UTC](https://discourse.nixos.org/t/2026-07-08-documentation-team-meeting-notes/78838 "2026-07-12T14:55:29Z")

</div>

Meeting info Past meeting notes Documentation office hours in the NixOS Calendar Attendees: @hsjobeki @wamirez @kiara @friedow @hgl @lassulus Notes by: everyone vision doc: nix.dev/maintainers/vision.md at master · Nix…

---

## [2026-06-10 Documentation team meeting notes](https://discourse.nixos.org/t/2026-06-10-documentation-team-meeting-notes/78195)

<div class="topic-metadata">

**Author:** [@hsjobeki](https://discourse.nixos.org/u/hsjobeki)\
**Replies:** 9\
**Last updated:** [July 6, 2026, 4:03pm UTC](https://discourse.nixos.org/t/2026-06-10-documentation-team-meeting-notes/78195 "2026-07-06T16:03:35Z")

</div>

Meeting info Past meeting notes Documentation office hours in the NixOS Calendar Attendees: @hsjobeki @wamirez @kiara @friedow @hgl @lassulus Notes by: everyone vision doc: nix.dev/maintainers/vision.md at d49ef7af7ef1…

---

## [2026-06-24 Documentation team meeting notes](https://discourse.nixos.org/t/2026-06-24-documentation-team-meeting-notes/78572)

<div class="topic-metadata">

**Author:** [@friedow](https://discourse.nixos.org/u/friedow)\
**Replies:** 6\
**Last updated:** [June 26, 2026, 6:10pm UTC](https://discourse.nixos.org/t/2026-06-24-documentation-team-meeting-notes/78572 "2026-06-26T18:10:18Z")

</div>

Meeting info Past meeting notes Documentation office hours in the NixOS Calendar Attendees: @hsjobeki @friedow Notes by: everyone Summary We discussed how to structure docs.nixos.org, how to handle page splitting and …

---

## [Better navigation of nixos.org manuals](https://discourse.nixos.org/t/better-navigation-of-nixos-org-manuals/2085)

<div class="topic-metadata">

**Author:** [@asymmetric](https://discourse.nixos.org/u/asymmetric)\
**Replies:** 25\
**Last updated:** [June 10, 2026, 8:45pm UTC](https://discourse.nixos.org/t/better-navigation-of-nixos-org-manuals/2085 "2026-06-10T20:45:22Z")

</div>

I was navigating the Nixpkgs manuals lately, and a couple of tweaks came to mind that would make navigation a lot easier: Have a table of contents static sidebar thingy, à la Rust book Keep the TOC at the top, but mak…

---

## [Reviving Nix Documentation Meetings](https://discourse.nixos.org/t/reviving-nix-documentation-meetings/78152)

<div class="topic-metadata">

**Author:** [@friedow](https://discourse.nixos.org/u/friedow)\
**Replies:** 1\
**Last updated:** [June 10, 2026, 3:35pm UTC](https://discourse.nixos.org/t/reviving-nix-documentation-meetings/78152 "2026-06-10T15:35:38Z")

</div>

After publishing the new vision for the documentation team, @hsjobeki and I received several requests from people asking how to get in touch with the documentation team and how to help make that vision a reality. So tod…

---

## [Progress of my GSoC Work](https://discourse.nixos.org/t/progress-of-my-gsoc-work/78161)

<div class="topic-metadata">

**Author:** [@DarshanCode2005](https://discourse.nixos.org/u/DarshanCode2005)\
**Replies:** 0\
**Last updated:** [June 9, 2026, 3:10pm UTC](https://discourse.nixos.org/t/progress-of-my-gsoc-work/78161 "2026-06-09T15:10:09Z")

</div>

Hi everyone, My name is Darshan, and I am a GSoC contributor working on the NixOS Security Tracker. Over the past few weeks, I have been focusing on understanding the codebase, improving the contributor experience, and h…

---

## [\`pkgs.linuxManualConfig\` no longer exists?](https://discourse.nixos.org/t/pkgs-linuxmanualconfig-no-longer-exists/73644)

<div class="topic-metadata">

**Author:** [@zwol](https://discourse.nixos.org/u/zwol)\
**Replies:** 8\
**Last updated:** [May 20, 2026, 4:09am UTC](https://discourse.nixos.org/t/pkgs-linuxmanualconfig-no-longer-exists/73644 "2026-05-20T04:09:11Z")

</div>

https://nixos.org/manual/nixpkgs/stable/#sec-linux-kernel says that there’s a function named pkgs.linuxManualConfig that can be used when “most of the common configuration has to be altered or disabled to achieve a kerne…

---

## [Printing/Scanning wiki using old option services.avahi.nssmdns](https://discourse.nixos.org/t/printing-scanning-wiki-using-old-option-services-avahi-nssmdns/77694)

<div class="topic-metadata">

**Author:** [@epskoon](https://discourse.nixos.org/u/epskoon)\
**Replies:** 2\
**Last updated:** [May 18, 2026, 3:37pm UTC](https://discourse.nixos.org/t/printing-scanning-wiki-using-old-option-services-avahi-nssmdns/77694 "2026-05-18T15:37:03Z")

</div>

Hello together, i was using the official wiki page for setting up printer and scanner support on my system which worked very well. However, i think the wiki mentions an outdated option called services.avahi.nssmdns, wh…

---

## [Nix Roadmaps (Skill Trees)](https://discourse.nixos.org/t/nix-roadmaps-skill-trees/64156)

<div class="topic-metadata">

**Author:** [@sshine](https://discourse.nixos.org/u/sshine)\
**Replies:** 8\
**Last updated:** [April 2, 2026, 3:27pm UTC](https://discourse.nixos.org/t/nix-roadmaps-skill-trees/64156 "2026-04-02T15:27:49Z")

</div>

Since an acquaintance showed me https://roadmap.sh a couple of weeks ago, I have been brewing on the idea of building different roadmaps with different angles for learning Nix. When I read the Nix Ecosystem Mind Map thre…

---

## [QEMU Documentation Reorganisation](https://discourse.nixos.org/t/qemu-documentation-reorganisation/74890)

<div class="topic-metadata">

**Author:** [@frey](https://discourse.nixos.org/u/frey)\
**Replies:** 9\
**Last updated:** [March 2, 2026, 11:23am UTC](https://discourse.nixos.org/t/qemu-documentation-reorganisation/74890 "2026-03-02T11:23:38Z")

</div>

Hello all, I am currently invested in learning to use QEMU to allow for fine-grained control over system and network virtualisation, using existing Linux tools declared with Nix. This seems like a perfect use case for N…

---

## [Imperative Containers bindMount](https://discourse.nixos.org/t/imperative-containers-bindmount/75434)

<div class="topic-metadata">

**Author:** [@TinajaStyle](https://discourse.nixos.org/u/TinajaStyle)\
**Replies:** 0\
**Last updated:** [February 18, 2026, 7:24am UTC](https://discourse.nixos.org/t/imperative-containers-bindmount/75434 "2026-02-18T07:24:24Z")

</div>

Is there any way to have mounts in imperative containers? I’ve searched and I suspect there isn’t. If there isn’t, I’d like to know why. I think it would be an excellent feature.

---

## [There are 3 Nvidia Wiki pages for NixOS](https://discourse.nixos.org/t/there-are-3-nvidia-wiki-pages-for-nixos/64066)

<div class="topic-metadata">

**Author:** [@LinuxIsBest](https://discourse.nixos.org/u/LinuxIsBest)\
**Replies:** 35\
**Last updated:** [December 18, 2025, 3:14pm UTC](https://discourse.nixos.org/t/there-are-3-nvidia-wiki-pages-for-nixos/64066 "2025-12-18T15:14:48Z")

</div>

I am trying to make a generic basic config (one size fits most) that others can use. The AMD and Intel configurations were really easy. But then I stumbled upon Nvidia, and discovered it was not going to be so easy, es…

---

## [Localization of nix.dev Documentation](https://discourse.nixos.org/t/localization-of-nix-dev-documentation/72247)

<div class="topic-metadata">

**Author:** [@hwhsu1231](https://discourse.nixos.org/u/hwhsu1231)\
**Replies:** 1\
**Last updated:** [November 24, 2025, 5:01pm UTC](https://discourse.nixos.org/t/localization-of-nix-dev-documentation/72247 "2025-11-24T17:01:12Z")

</div>

Hello, NixOS Community, I’m glad to announce that the :tada: nix-dev-docs-l10n :tada: project is published now: :rocket: Preview: nix-dev-docs-l10n :globe\_with\_meridians: Crowdin: nix-dev-docs-l10n :octopus: GitHub: n…

---

## [Automatic Updates - doc bug?](https://discourse.nixos.org/t/automatic-updates-doc-bug/71341)

<div class="topic-metadata">

**Author:** [@Roo](https://discourse.nixos.org/u/Roo)\
**Replies:** 0\
**Last updated:** [October 25, 2025, 7:59pm UTC](https://discourse.nixos.org/t/automatic-updates-doc-bug/71341 "2025-10-25T19:59:07Z")

</div>

I was setting up my system for automatic updates and copied the “Channel-based systems (default)” which includes flags = \[ "--print-build-logs" \]; The auto-update got an error saying --print-build-logs was no…

---

## [Life of a pull request against NixOS/nixpkgs](https://discourse.nixos.org/t/life-of-a-pull-request-against-nixos-nixpkgs/21691)

<div class="topic-metadata">

**Author:** [@drupol](https://discourse.nixos.org/u/drupol)\
**Replies:** 15\
**Last updated:** [October 1, 2025, 5:54pm UTC](https://discourse.nixos.org/t/life-of-a-pull-request-against-nixos-nixpkgs/21691 "2025-10-01T17:54:21Z")

</div>

Hi, I’m trying to have a global overview of what is happening when a contributor submits a PR against NixOS/nixpkgs. I made a UML workflow available here, do you think you could make a review and let me know what’s mis…

---

## [Can I add libraries with no dependents \_inside\_ nixpkgs?](https://discourse.nixos.org/t/can-i-add-libraries-with-no-dependents-inside-nixpkgs/66396)

<div class="topic-metadata">

**Author:** [@jherland](https://discourse.nixos.org/u/jherland)\
**Replies:** 7\
**Last updated:** [September 22, 2025, 7:00pm UTC](https://discourse.nixos.org/t/can-i-add-libraries-with-no-dependents-inside-nixpkgs/66396 "2025-09-22T19:00:14Z")

</div>

Hi, as part of helping a client upstream suitable parts of their nixpkgs overlay, I’m adding some new packages to nixpkgs. Some of these packages are libraries that (as of now) have no users/dependents inside nixpkgs, b…

---

## [Official preference when multiple aliases are available?](https://discourse.nixos.org/t/official-preference-when-multiple-aliases-are-available/69458)

<div class="topic-metadata">

**Author:** [@isti115](https://discourse.nixos.org/u/isti115)\
**Replies:** 3\
**Last updated:** [September 17, 2025, 6:20pm UTC](https://discourse.nixos.org/t/official-preference-when-multiple-aliases-are-available/69458 "2025-09-17T18:20:54Z")

</div>

I have been looking for guidance on best practice regarding the usage of aliased library functions, such as builtins.concatStringsSep, lib.concatStringsSep and lib.strings.concatStringsSep, but was unable to find any so …

---

## [\`inherit\` with an expression](https://discourse.nixos.org/t/inherit-with-an-expression/68896)

<div class="topic-metadata">

**Author:** [@miniBill](https://discourse.nixos.org/u/miniBill)\
**Replies:** 6\
**Last updated:** [September 8, 2025, 9:45am UTC](https://discourse.nixos.org/t/inherit-with-an-expression/68896 "2025-09-08T09:45:45Z")

</div>

As part of a project I hope to unveil soon™ I’m writing a parser for Nix. I currently have most of the language, as far as I can tell, and I’m testing it on nixpkgs, where I found this: # nixpkgs/pkgs/applications/video…

---

## [The next chapter in Nix documentation](https://discourse.nixos.org/t/the-next-chapter-in-nix-documentation/68425)

<div class="topic-metadata">

**Author:** [@fricklerhandwerk](https://discourse.nixos.org/u/fricklerhandwerk)\
**Replies:** 4\
**Last updated:** [August 25, 2025, 8:40pm UTC](https://discourse.nixos.org/t/the-next-chapter-in-nix-documentation/68425 "2025-08-25T20:40:43Z")

</div>

The documentation team has been largely inactive in the past year, mainly due to resource constraints and competing priorities. It’s long overdue to make room for succession and create opportunities to rejuvenate the eff…

---

## [Sphinx support for Nix?](https://discourse.nixos.org/t/sphinx-support-for-nix/4998)

<div class="topic-metadata">

**Author:** [@parkerhoyes](https://discourse.nixos.org/u/parkerhoyes)\
**Replies:** 7\
**Last updated:** [July 30, 2025, 3:49pm UTC](https://discourse.nixos.org/t/sphinx-support-for-nix/4998 "2025-07-30T15:49:11Z")

</div>

I’ve only just started experimenting with Nix recently but so far I’ve enjoyed how expressive and powerful the build system can be. One thing I have not enjoyed however is the lack of documentation in certain areas, esp…

[Next page](https://discourse.nixos.org/c/dev/documentation/25.md?page=1)
