Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Release 26.11

This is the current unstable branch and the information in this section is therefore not final.

Highlights

This release has the following notable changes:

  • The programs.uv module can now install uv-managed Python versions and tools through the new programs.uv.python.versions, programs.uv.python.default, and programs.uv.tool.packages options. Unpinned entries track the latest release on each activation while pinned ones stay put, and programs.uv.python.prune / programs.uv.tool.prune make the managed set fully declarative by removing versions and tools that are no longer listed.

  • On Darwin, Home Manager launchd agents now support launchd.agents.name.domain to choose either the user’s GUI or background launchd domain. Agents use the GUI domain by default. Set the domain to user for agents that should run without an active graphical login session.

  • The services.voxtype.enable daemon now starts as part of graphical-session.target instead of default.target. Starting after the compositor owns its GPU render node lets Vulkan-accelerated whisper builds detect their device. Previously, a daemon that started before the render node existed fell back to CPU and never recovered until it was restarted manually.

  • XSuspender now uses services.xsuspender.settings for freeform INI configuration. Move services.xsuspender.defaults to services.xsuspender.settings.Default and services.xsuspender.rules to services.xsuspender.settings.<name>. Use snake_case keys such as suspend_delay instead of suspendDelay.

    Deprecated aliases warn and preserve old defaults, including legacy function reads, in legacy sections and Default. These defaults have option-default priority, so ordinary assignments override them. Settings-only sections inherit from Default at runtime, then use native defaults. To preserve old behavior, set suspend_delay to 5 and only_on_battery to false, rather than 10 and true.

    Without legacy options, empty settings leave the configuration file unmanaged. If you configured both services.xsuspender.defaults and services.xsuspender.rules.Default, consolidate them under services.xsuspender.settings.Default. They now merge instead of the rule replacing the entire defaults section.

  • TWMN now uses services.twmn.settings for freeform INI configuration. Legacy options emit migration warnings. Move native options and extraConfig values into settings, resolving duplicate definitions. Enabling the service without configuration no longer creates a config file. Settings-only configurations use TWMN’s native defaults; see the option documentation for compatibility limits and preserving previous defaults.

State Version Changes

The state version in this release includes the changes below. These changes are only active if the home.stateVersion option is set to “26.11” or later.

  • On Darwin, the default value of programs.firefox.configPath changes from Library/Application Support/Firefox to Library/Application Support/org.nixos.firefox when programs.firefox.package is not null. Explicit configPath values remain unchanged. Users with a home.stateVersion earlier than "26.11" should set programs.firefox.configPath = "Library/Application Support/org.nixos.firefox"; explicitly. Before changing configPath, quit Firefox and move your data from ~/Library/Application Support/Firefox to ~/Library/Application Support/org.nixos.firefox.

  • The KDL options under programs.zellij will now correctly escape backslashes in string values. For example, the Nix string "\\" will now correctly generate the KDL string "\\". Previously, this would have generated "\", which is invalid KDL. The following options are affected:

    • programs.zellij.settings
    • programs.zellij.themes
    • programs.zellij.layouts

  • The KDL options under programs.zellij will now escape tabs in string values. For example, the Nix string "\t" (corresponding to a single tab) will now generate the KDL string "\t". Previously, this would have generated "<tab>" (where <tab> denotes a literal tab character). The following options are affected:

    • programs.zellij.settings
    • programs.zellij.themes
    • programs.zellij.layouts