Appendix B. Release Notes

Bazecor, the graphical configurator for Dygma Products.

Kimai, a web-based multi-user time-tracking application. Available as services.kimai.

Omnom, a webpage bookmarking and snapshotting service. Available as services.omnom.

Traccar, a modern GPS Tracking Platform. Available as services.traccar.

crab-hole, a cross platform Pi-hole clone written in Rust using hickory-dns/trust-dns. Available as services.crab-hole.

Amazon CloudWatch Agent, the official telemetry collector for AWS CloudWatch and AWS X-Ray. Available as services.amazon-cloudwatch-agent.

Bat, a cat(1) clone with wings. Available as programs.bat.

agorakit, an organization tool for citizens’ collectives. Available with services.agorakit.

mqtt-exporter, a Prometheus exporter for exposing messages from MQTT. Available as services.prometheus.exporters.mqtt.

Buffyboard, a framebuffer on-screen keyboard. Available as services.buffyboard.

KanBoard, a project management tool that focuses on the Kanban methodology. Available as services.kanboard.

git-worktree-switcher, switch between git worktrees with speed. Available as programs.git-worktree-switcher

binwalk was updated to 3.1.0, which has been rewritten in rust. The python module is no longer available. See the release notes of 3.1.0 for more information.

buildGoPackage has been removed. Use buildGoModule instead. See the Go section in the nixpkgs manual for details.

strawberry has been updated to 1.2, which drops support for the VLC backend and Qt 5. The strawberry-qt5 package and withGstreamer/withVlc override options have been removed due to this.

timescaledb requires manual upgrade steps. After you run ALTER EXTENSION, you must run this SQL script. For more details, see the following pull requests #6797. PostgreSQL 13 is no longer supported in TimescaleDB v2.16.

Support for CUDA 10 has been dropped, as announced in the 24.11 release notes.

zammad has had its support for MySQL removed, since it was never working correctly and is now deprecated upstream. Check the migration guide for how to convert your database to PostgreSQL.

nodePackages.vls has been deprecated, as the upstream consumer of it, vetur, has been deprecated by upstream. Upstream suggests migrating to Volar for Vue LSP tooling instead.

nodePackages.create-react-native-app has been removed, as it is deprecated. Upstream suggests using a framework for React Native apps instead.

nodePackages.insect has been removed, as it’s deprecated by upstream. The suggested replacement is numbat.

nodePackages.webpack-dev-server has been removed, as it should be installed in projects that use it instead.

racket_7_9 has been removed, as it is insecure. It is recommended to use Racket 8 instead.

fluxus has been removed, as it depends on racket_7_9 and had no updates in 9 years.

renovate was updated to v39. See the upstream release notes for breaking changes. Like upstream’s docker images, renovate now runs on NodeJS 22.

The behavior of the networking.nat.externalIP and networking.nat.externalIPv6 options has been changed. networking.nat.forwardPorts now only forwards packets destined for the specified IP addresses.

nodePackages.meshcommander has been removed, as the package was deprecated by Intel.

kanata was updated to v1.7.0, which introduces several breaking changes. See the release notes of v1.7.0 for more information.

nodePackages.expo-cli has been removed, as it was deprecated by upstream. The suggested replacement is the npx expo command.

vscode-utils.buildVscodeExtension now requires pname as an argument

nerdfonts has been separated into individual font packages under the namespace nerd-fonts. The directories for font files have changed from $out/share/fonts/{opentype,truetype}/NerdFonts to $out/share/fonts/{opentype,truetype}/NerdFonts/<fontDirName>, where <fontDirName> can be found in the official website as the titles in preview images, with the “Nerd Font” suffix and any whitespaces trimmed. Configuration changes are required, see build output.

retroarch has been refactored and the older retroarch.override { cores = [ ... ]; } to create a RetroArch derivation with custom cores doesn’t work anymore, use retroarch.withCores (cores: [ ... ]) instead. If you need more customization (e.g.: custom settings), use wrapRetroArch instead.

gkraken software and hardware.gkraken.enable option have been removed, use coolercontrol via programs.coolercontrol.enable option instead.

nodePackages.ganache has been removed, as the package has been deprecated by upstream.

containerd has been updated to v2, which contains breaking changes. See the containerd 2.0 documentation for more details.

nodePackages.stackdriver-statsd-backend has been removed, as the StackDriver service has been discontinued by Google, and therefore the package no longer works.

the notmuch vim plugin now lives in a separate output of the notmuch package. Installing notmuch will not bring the notmuch vim package anymore, add vimPlugins.notmuch-vim to your (Neo)vim configuration if you want the vim plugin.

prisma and prisma-engines have been updated to version 6.0.1, which introduces several breaking changes. See the Prisma ORM upgrade guide for more information.

zf was updated to 0.10.2, which includes breaking changes from the 0.10.0 release. zf no longer does Unicode normalization of the input and no longer supports terminal escape sequences in the ZF_PROMPT environment variable.

Cinnamon has been updated to 6.4.

networking.wireguard now has an optional networkd backend. It is enabled by default when networking.useNetworkd is enabled, and it can be enabled alongside scripted networking with networking.wireguard.useNetworkd. Some networking.wireguard options have slightly different behavior with the networkd and script-based backends, documented in each option.

services.avahi.ipv6 now defaults to true.

bind.cacheNetworks now only controls access for recursive queries, where it previously controlled access for all queries.

Nix was updated to 2.24, which brings a lot of improvements and fixes. See the release notes for 2.19, 2.20, 2.21, 2.22, 2.23, 2.24. Notable changes include improvements to Git fetching, documentation comment support in nix-repl> :doc, as well as many quality of life additions.

There have been significant changes to macOS support.

This will be the last release of Nixpkgs to support versions of CUDA prior to CUDA 12.0. These versions only work with old compiler versions that will be unsupported by the time of the Nixpkgs 25.05 release. In the future, users should expect CUDA versions to be dropped as the compiler versions they require leave upstream support windows.

Convenience options for amdgpu, the open source driver for Radeon cards, are now available under hardware.amdgpu.

AMDVLK, AMD’s open source Vulkan driver, is now available to be configured under the hardware.amdgpu.amdvlk option. This also allows configuring runtime settings for AMDVLK, including enabling experimental features.

The moonlight-qt package (for Moonlight game streaming) now has HDR support on Linux systems.

Sched-ext, a Linux kernel feature to run schedulers in userspace, is now available services.scx. Requires Linux kernel version 6.12 or later.

PostgreSQL now defaults to major version 16.

GNOME has been updated to version 47. Refer to the release notes for more details.

authelia has been upgraded to version 4.38. This version brings several features and improvements which are detailed in the release blog post. This release also deprecates some configuration keys which are likely to be removed in version 5.0.0.

netbird has been updated to 0.31.1. This adds a built-in relay server which is not yet supported by the NixOS module, as well as a metrics endpoint for both the management and signal services. The default metrics port for the signal service has been changed from 9090 to 9091 to prevent a port conflict with the management server. This can be changed with their respective metricsPort as needed. Refer to the release notes and this pull request for more information.

compressDrv can compress selected files in a derivation. compressDrvWeb compresses files for common web server usage (.gz with zopfli, .br with brotli).

hardware.display is a new module implementing workarounds for misbehaving monitors by setting up custom EDID files and forcing kernel/framebuffer modes.

services.displayManager.ly is a new module for configuring the display manager ly, a TUI-based replacement for SDDM and LightDM meant for window manager users.

srcOnly was rewritten to be more readable, have additional warnings in the event that something is probably wrong, use the stdenv provided by the derivation, and Noogle-compatible documentation was added.

The default sound server for most graphical sessions has been switched from PulseAudio to PipeWire. Users that want to keep using PulseAudio will want to set services.pipewire.enable = false; and hardware.pulseaudio.enable = true;. There is currently no plan to fully deprecate and remove PulseAudio, however, PipeWire should generally be preferred for new installs.

The Rust rewrite of the switch-to-configuration program is now used for system activation by default. If you experience any issues, please report them. The original Perl script is deprecated and is planned for removal in the 25.05 release. It will remain accessible until then by setting system.switch.enableNg to false.

Support for mounting filesystems from block devices protected with dm-verity was added through the boot.initrd.systemd.dmVerity option.

The Xen Project Hypervisor is once again available as a virtualisation option under virtualisation.xen.

A new option systemd.enableStrictShellChecks has been added. When enabled, all systemd scripts generated by NixOS will be checked with shellcheck and any errors or warnings will cause the build to fail. This affects all scripts that have been created through the script, reload, preStart, postStart, preStop and postStop options for systemd services. This does not affect commandlines passed directly to ExecStart, ExecReload, ExecStartPre, ExecStartPost, ExecStop or ExecStopPost. It therefore also does not affect systemd units that are coming from packages and that are not defined through the NixOS config. This option is disabled by default, and although some services have already been fixed, it is still likely that you will encounter build failures when enabling this. We encourage people to enable this option when they are willing and able to submit fixes for potential build failures to nixpkgs. The option can also be enabled or disabled for individual services using the enableStrictShellChecks option on the service itself, which will take precedence over the global setting.

Coral, hardware support for Coral.ai Edge TPU devices. Available as hardware.coral.usb.enable and hardware.coral.pcie.enable.

Cyrus IMAP, an email, contacts and calendar server. Available as services.cyrus-imap service.

TaskChampion Sync-Server, a Taskwarrior 3 sync server. Available as services.taskchampion-sync-server.

FlareSolverr, a proxy server to bypass Cloudflare protection. Available as services.flaresolverr.

Gancio, a shared agenda for local communities. Available as services.gancio.

Goatcounter, an easy web analytics platform with no tracking of personal data. Available as services.goatcounter.

Privatebin, a minimalist, open source online pastebin where the server has zero knowledge of pasted data. Available as services.privatebin.

UWSM, a wayland session manager to wrap Wayland compositors into useful systemd units such as graphical-session.target. Available as programs.uwsm.

Open-WebUI, a user-friendly WebUI for LLMs. Available as services.open-webui.

Quickwit, a sub-second search & analytics engine on cloud storage. Available as services.quickwit.

Userborn, a service for declarative user management. This can be used instead of the update-users-groups.pl Perl script and/or systemd-sysusers. This is now recommended over systemd-sysusers to achieve a system without Perl, as it can create normal users and change passwords. Available as services.userborn.

g810-led, a LED controller for Logitech G keyboards. Available as services.g810-led.

Hatsu, a self-hosted bridge that interacts with Fediverse on behalf of your static site. Available as services.hatsu.

Soteria, a polkit authentication agent to handle elevated prompts for any desktop environment. Normally this should only be used on DEs or WMs that do not provide a graphical polkit frontend on their own. Available as security.soteria.

Flood, a beautiful WebUI for various torrent clients. Available as services.flood.

Niri, a scrollable-tiling Wayland compositor. Available as programs.niri.

Firefly-iii Data Importer, a data importer for Firefly-III. Available as services.firefly-iii-data-importer.

Dashy, an open source, highly customizable, easy to use, privacy-respecting dashboard app. Available as services.dashy.

[QGroundControl], a ground station support and configuration manager for the PX4 and APM Flight Stacks. Available as programs.qgroundcontrol.

Eintopf, a community event and calendar web application. Available as services.eintopf.

pay-respects, a terminal command correction program, alternative to thefuck, written in Rust. Available as programs.pay-respects.

Radicle, an open source, peer-to-peer code collaboration stack built on Git. Available as services.radicle.

Ordinal, A library for ordinal numbers in the Coq proof assistant.

ddns-updater, a service with a WebUI to update DNS records periodically for many providers. Available as services.ddns-updater.

Immersed, a closed-source coworking platform. Available as programs.immersed.

HomeBox, an inventory and organization system built for the home user. Available as services.homebox.

evremap, a keyboard input remapper for Linux/Wayland systems. Available as services.evremap.

matrix-hookshot, a Matrix bot for connecting to external services. Available as services.matrix-hookshot.

Renovate, a dependency updating tool for various Git forges and language ecosystems. Available as services.renovate.

Music Assistant, a music library manager for your offline and online music sources that can stream to a wide range of supported players. Available as services.music-assistant.

zeronsd, a DNS server for ZeroTier users. Available with services.zeronsd.servedNetworks.

Collabora Online, a collaborative online office suite based on LibreOffice technology. Available as services.collabora-online.

wg-access-server, an all-in-one WireGuard VPN solution with a WebUI for connecting devices. Available as services.wg-access-server.

Pingvin Share, a self-hosted file sharing platform and an alternative for WeTransfer. Available as services.pingvin-share.

Envision, a UI for building, configuring and running Monado, the open source OpenXR runtime. Available as programs.envision.

Localsend, an open source cross-platform alternative to AirDrop. Available as programs.localsend.

Gatus, an automated developer-oriented status page. Available as services.gatus.

cryptpad, a privacy-oriented collaborative office suite, has been added back. Available as services.cryptpad.

realm, a simple, high performance relay server written in Rust. Available as services.realm.

Gotenberg, an API server for converting files to PDFs that can be used alongside Paperless-ngx. Available as services.gotenberg.

Suricata, a free and open source, mature, fast and robust network threat detection engine. Available as services.suricata.

Playerctld, a daemon to track media player activity. Available as services.playerctld.

Glance, a self-hosted dashboard that puts all your feeds in one place. Available as services.glance.

Apache Tika, a toolkit that detects and extracts metadata and text from over a thousand different file types. Available as services.tika.

Misskey, an interplanetary microblogging platform. Available as services.misskey.

Improved File Manager (IFM), a single-file web-based file manager. Available as services.ifm.

OpenGFW, an implementation of the Great Firewall on Linux. Available as services.opengfw.

Rathole, a lightweight and high-performance reverse proxy for NAT traversal. Available as services.rathole.

Proton Mail bridge, a desktop application that runs in the background, encrypting and decrypting messages as they enter and leave your computer. Available as services.protonmail-bridge.

chromadb, an open-source AI application database with batteries included. Available as services.chromadb.

bitmagnet, a self-hosted BitTorrent indexer, DHT crawler, content classifier and torrent search engine with WebUI, GraphQL API and Servarr stack integration. Available as services.bitmagnet.

Wakapi, a time tracking software for programmers. Available as services.wakapi.

foot, a fast, lightweight and minimalistic Wayland terminal emulator. Available as programs.foot.

ToDesk, a remote desktop application. Available as services.todesk.

Dependency Track, an intelligent Component Analysis platform that allows organizations to identify and reduce risk in the software supply chain. Available as services.dependency-track.

Immich, a self-hosted photo and video backup solution. Available as services.immich.

saunafs, a distributed POSIX file system. Available as services.saunafs.

obs-studio, a free and open source software for video recording and live streaming. Available as programs.obs-studio.

Veilid, a privacy-focused, headless server for data sharing and messaging on a peer-to-peer network. Available as services.veilid.

Fedimint, a module based system for building federated applications (Federated E-Cash Mint). Available as services.fedimintd.

tiny-dfr, a dynamic function row daemon for the Touch Bar found on some Apple laptops. Available as hardware.apple.touchBar.enable.

Swapspace, a dynamic swap space manager that turns your unused free space into swap automatically. Available as services.swapspace.

Zapret, a DPI bypass tool. Available as services.zapret.

Glances, an open-source system cross-platform monitoring tool. Available as services.glances.

Nixpkgs now requires Nix 2.3.17 or newer to allow for zstd compressed binary artifacts.

The sound options have been removed or renamed, as they had a lot of unintended side effects. See below for details.

The NVIDIA driver no longer defaults to the proprietary kernel module with versions >= 560. You will need to manually set hardware.nvidia.open to select the proprietary or open modules.

The (buildPythonPackage { ... }).override and (buildPythonPackage { ... }).overrideDerivation attributes is now deprecated and removed in favour of overridePythonAttrs and lib.overrideDerivation. This change does not affect the override interface of most Python packages, as <pkg>.override provided by callPackage shadows such a locally-defined override attribute. The <pkg>.overrideDerivation attribute of Python packages called with callPackage will also remain available after this change.

All Cinnamon and XApp packages have been moved to top-level (i.e., cinnamon.nemo is now nemo).

All GNOME packages have been moved to top-level (i.e., gnome.nautilus is now nautilus).

transmission has been aliased with a trace warning to transmission_3, since Transmission 4 has been released last year and Transmission 3 will eventually go away – this is meant to make people aware of the new version. services.transmission.package now also defaults to transmission_3, as the upgrade can cause data loss in some cases (examples: #5153, #6796). Please make sure to back up to your data directory if you may be affected:

The default mongodb version has been updated from 5.0 to 7.0. For more information, see the compatibility changes for MongoDB 6.0 and 7.0.

unifi has been updated to UniFi 8. unifi7 was removed as it is vulnerable to CVE-2024-42025 and required a version of MongoDB that has reached end of life.

androidenv.androidPkgs_9_0 has been removed. It is replaced with androidenv.androidPkgs for a more complete Android SDK, including support for Android 9 and later.

The VirtualBox demo installer appliance has been removed. Please use the standard installer ISOs instead.

grafana has been updated to version 11.3. This version doesn’t support setting http_addr to a hostname anymore, an IP address is expected.

deno has been updated to Deno 2, which has breaking changes. See the migration guide for details.

gogs has been removed. Upstream development has stalled and it has several critical vulnerabilities that weren’t addressed within a year. Consider migrating to forgejo or gitea.

knot-dns has been updated to version 3.4.x. Check the migration guide for breaking changes.

mutmut has been updated to version 3.0.5.

services.kubernetes.kubelet.clusterDns now accepts a list of DNS resolvers rather than a single string, bringing the module more in line with the upstream Kubelet configuration schema.

bluemap has changed the format used to store map tiles, and the database layout has been heavily modified. Upstream recommends a clean reinstallation: https://github.com/BlueMap-Minecraft/BlueMap/releases/tag/v5.2. Unless you are using an SQL storage backend, this should only entail deleting the contents of config.services.bluemap.coreSettings.data (defaults to /var/lib/bluemap) and config.services.bluemap.webRoot (defaults to /var/lib/bluemap/web).

wstunnel has had a major version upgrade that entailed rewriting the program in Rust. The module was updated to accommodate for breaking changes and breaking changes to the module options were minimised as much as possible. Nonetheless, some were inevitable due to changes in the upstream CLI. Certain options were moved from separate CLI arguments into the forward specifications, and those options were also removed from the module’s options. Please consult the wstunnel man page for more details. Also be aware that if you have set additional options in services.wstunnel.{clients,servers}.<name>.extraArgs, they may have been modified or removed upstream.

gnat and gnatPackages now use GNAT 13 instead of GNAT 12. This matches the default gcc version.

percona-server_8_4 and mysql84 now have password authentication via the deprecated mysql_native_password disabled by default. This authentication plugin can be enabled via a CLI argument again, for detailed instructions and alternative authentication methods see upstream documentation. The config file directive default_authentication_plugin has been removed.

Percona has decided not to follow the LTS/ Innovation release scheme of upstream MySQL and thus will only create releases for MySQL LTS versions. Hence, the package names percona-server_lts, percona-server_innovation, percona-xtrabackup_lts and percona-xtrabackup_innovation are deprecated.

clang-tools_<version> packages have been moved into llvmPackages_<version> (i.e. clang-tools_18 is now llvmPackages_18.clang-tools).

buildbot was updated to 4.0 and the AngularJS frontend replaced by a React frontend. See the upstream release notes.

headscale has been updated to version 0.23.0 which reworked large parts of the configuration, including DNS, Magic DNS prefixes and ACL policy files. See the upstream changelog for details.

nginx package no longer includes the gd and geoip dependencies. To re-enable them, override nginx with the options withImageFilter = true; and withGeoIP = true;.

systemd.enableUnifiedCgroupHierarchy has been removed. In systemd 256, support for cgroup v1 (‘legacy’ and ‘hybrid’ hierarchies) is now considered obsolete and systemd will refuse to boot under it by default. To forcibly re-enable cgroup v1 support, you can set boot.kernelParams = [ "systemd.unified_cgroup_hierarchy=0" "SYSTEMD_CGROUP_ENABLE_LEGACY_FORCE=1" ]. This is not an officially supported configuration and might cause your system to become unbootable in future versions. You are on your own.

nrfutil – which previously pointed to the now-deprecated pc-nrfutil Python package – has been repackaged under the same name with the new nrfutil tool.

openssh and openssh_hpn are now compiled without Kerberos 5 / GSSAPI support in an effort to reduce the attack surface of the components. Users needing this support can use the new opensshWithKerberos and openssh_hpnWithKerberos package flavors (e.g. programs.ssh.package = pkgs.openssh_gssapi).

security.ipa.ipaHostname now defaults to the value of networking.fqdn if it is set, instead of the previous hardcoded default of ${networking.hostName}.${security.ipa.domain}.

The MSMTP_QUEUE and MSMTP_LOG environment variables accepted by msmtpq have been renamed to MSMTPQ_Q and MSMTPQ_LOG respectively.

The logrotate service has been hardened and now requires enabling allowNetworking if network access is required.

mautrix-whatsapp has been updated to version 0.11.0, which is a major rewrite of the bridge. Config file changes are required.

qBittorrent has been updated to major version 5, which drops support for Qt 5. The qbittorrent-qt5 package has been removed.

The fcgiwrap module now allows multiple instances running as distinct users. The option services.fgciwrap now takes an attribute set of the configuration of each individual instance. This requires migrating any previous configuration keys from services.fcgiwrap.* to services.fcgiwrap.instances.some-instance.*. The ownership and mode of the UNIX sockets created by this service are now configurable and private by default. Processes also now run as a dynamically allocated user by default instead of root.

The mautrix-signal module was adapted to incorporate the configuration changes that resulted from the update to the mautrix bridgev2 architecture. Pre-0.7.0 configurations should continue to work. In case you want to update your configuration, make sure to check the NixOS manual.

cargo-tauri has been updated to major version 2. Please review the migration guide. v1 of cargo-tauri is still available as cargo-tauri_1, but will be removed in future releases.

The nvidia driver no longer defaults to the proprietary driver starting with version 560. You will need to manually set hardware.nvidia.open to select the proprietary or open driver.

postgresql_12 has been removed since it reached its end of life.

postgresql no longer accepts the enableSystemd override. Use systemdSupport instead.

postgresql was split into default and -dev outputs. To make this work without circular dependencies, the output of the pg_config system view has been removed. The pg_config binary is provided in the -dev output and still works as expected.

The arguments from services.postgresql.initdbArgs now get shell-escaped.

postgresql is now hardened by default using the common systemd settings for that.

The dhcpcd service (networking.useDHCP) has been hardened and now runs exclusively as the “dhcpcd” user. Users that were relying on the root privileges in networking.dhcpcd.runHook will have to write specific sudo or polkit rules to allow dhcpcd to perform privileged actions.

As part of these changes, the DHCP lease files directory has also been moved from /var/db/dhcpcd to /var/lib/dhcpcd. This migration is performed automatically, but users may have to update their backup configuration.

singularity-tools have the storeDir argument removed from its override interface and use builtins.storeDir instead.

The mkLayer and shellScript build helpers in singularity-tools are deprecated, as they are no longer involved in image-building. Maintainers will remove them in future releases.

The rust.toTargetArch, rust.toTargetOs, rust.toTargetFamily, rust.toTargetVendor, rust.toRustTarget, rust.toRustTargetSpec, rust.toRustTargetSpecShort, and rust.IsNoStdTarget functions are deprecated in favour of the rust.platform.arch, rust.platform.os, rust.platform.target-family, rust.platform.vendor, rust.rustcTarget, rust.rustcTargetSpec, rust.cargoShortTarget, rust.cargoEnvVarTarget, and rust.isNoStdTarget platform attributes respectively.

All Budgie and budgiePlugins packages have been moved to top-level (i.e., budgie.budgie-desktop is now budgie-desktop and budgiePlugins.budgie-media-player-applet is now budgie-media-player-applet).

The method of safely handling secrets in the networking.wireless module has been changed to benefit from a new feature of wpa_supplicant. The syntax to refer to secrets has changed slightly and the option networking.wireless.environmentFile has been replaced by networking.wireless.secretsFile; see the description of the latter for how to upgrade.

NetBox was updated to >= 4.1.0. Have a look at the breaking changes of the 4.0 release and the 4.1 release, make the required changes to your database, if needed, then upgrade by setting services.netbox.package = pkgs.netbox_4_1; in your configuration.

services.cgit now runs as the cgit user by default instead of root. This change requires granting access to the repositories to this user or setting the appropriate one through services.cgit.some-instance.user.

All Oracle JDKs and JREs (oraclejdk, oraclejdk8, oraclejre, oraclejre8, jrePlugin, jre8Plugin, jdkdistro, oraclejdk8distro, and oraclejdk11) were dropped due to being unmaintained and heavily insecure. OpenJDK provides compatible replacements for JDKs and JREs.

gradle_6 was removed due to being unsupported upstream as of 10 Feb 2023. Additionally, it had numerous security vulnerabilities that were only patched in later versions, such as CVE-2021-29429, CVE-2021-29427, CVE-2021-29428, and CVE-2021-32751.

nvimpager was updated to version 0.13.0, which changes the order of user and nvimpager settings: user commands in -c and --cmd now override the respective default settings because they are executed later.

javacard-devkit was dropped due to having a dependency on the Oracle JDK, as well as being several years out-of-date.

Kubernetes featureGates have changed from a listOf str to attrsOf bool. This refactor makes it possible to also disable feature gates, without having to use extraOpts flags.

A previous configuration may have looked like this:

{
  featureGates = [ "EphemeralContainers" ];
  extraOpts = pkgs.lib.concatStringsSep " " (
    [
      ''--feature-gates="CSIMigration=false"''
    ]
  );
}

Using an attribute set instead, the new configuration would be:

{
  featureGates = {
    EphemeralContainers = true;
    CSIMigration=false;
  };
}

pkgs.nextcloud27 has been removed as it has reached EOL.

The environment.noXlibs option has been removed. It was a common source of unexpected rebuilds and breakage that was often hard to diagnose. If you need to disable certain libraries, you’re encouraged to add your own overlay to your configuration that targets the packages you care about.

frigate was updated past 0.14.0. This release includes various breaking changes, so please review the release notes. Most prominently, access to the web interface and API are now protected by authentication. Retrieve the auto-created admin account from the frigate.service journal after upgrading.

nodePackages.coc-python was dropped, as its upstream is unmaintained. The associated vimPlugins.coc-python was also dropped. The upstream project recommends using coc-pyright or coc-jedi as replacements.

forgejo has been upgraded from version 7.0 to version 9.0, see the release notes for 8.0 and 9.0.

services.forgejo.mailerPasswordFile has been deprecated by the drop-in replacement services.forgejo.secrets.mailer.PASSWD, which is part of the new free-form services.forgejo.secrets option. services.forgejo.secrets is a small wrapper over systemd’s LoadCredential=. It has the same structure (sections/keys) as services.forgejo.settings but takes file paths that will be read before service startup instead of some plaintext value. services.forgejo.package now defaults to forgejo-lts, the Long Term Support version of Forgejo.

forgejo and forgejo-lts no longer support the opt-in feature PAM (Pluggable Authentication Module).

gitea no longer supports the opt-in feature PAM (Pluggable Authentication Module).

vuze was removed because it is unmaintained upstream and insecure (CVE-2018-13417). BiglyBT is a maintained fork.

services.ddclient.use has been deprecated: ddclient now supports separate IPv4 and IPv6 configuration. Use services.ddclient.usev4 and services.ddclient.usev6 instead.

services.pgbouncer systemd service is now configured with Type=notify-reload and allows reloading configuration without process restart. PgBouncer configuration options were moved to the freeform type option under services.pgbouncer.settings.

Docear was removed because it was unmaintained upstream. JabRef, Zotero, or Mendeley are potential replacements.

nodePackages.coc-metals was removed due to being deprecated upstream. vimPlugins.nvim-metals is its official replacement.

matrix-sliding-sync was removed because it has been replaced by the simplified sliding sync functionality introduced in matrix-synapse 114.0.

nodePackages.coc-tslint, vimPlugins.coc-tslint, nodePackages.coc-tslint-plugin, and vimPlugins.coc-tslint-plugin were removed due to being deprecated upstream. The nodePackages.coc-eslint and vimPlugins.coc-eslint packages offer comparable features for eslint, which replaced tslint.

Tcl packages have been moved into the tclPackages scope.

teleport has been upgraded from major version 15 to major version 16. Refer to upstream upgrade instructions and release notes for v16.

tests.overriding’s passthru.tests has been restructured as an attribute set instead of a list, making individual tests accessible by their names.

skk-dict was split into multiple packages under skkDictionaries. If in doubt of what to use, try skkDictionaries.l. As part of this change, the dictionaries were moved from $out/share to $out/share/skk. The dictionaries also won’t be converted to UTF-8 unless the useUtf8 package option is enabled; UTF-8 converted dictionaries will have the .utf8 suffix appended to its filename.

vaultwarden lost the capability to bind to privileged ports. If you rely on this behavior, override the systemd unit to allow CAP_NET_BIND_SERVICE in your configuration.

services.invoiceplane.sites.<name>.extraConfig was removed. Configuration must now be done through the structured services.invoiceplane.sites.<name>.settings option.

services.ollama.sandbox has been replaced with options to configure a static user and group. The writablePaths option has also been removed and the models directory is now always exempt from sandboxing.

The gns3-server service now runs under the gns3 system user instead of a dynamically created one via DynamicUser. The use of SUID wrappers is incompatible with SystemD’s DynamicUser setting, and GNS3 requires calling ubridge through its SUID wrapper to function properly. This change requires to manually move the following directories:

Legacy package stalwart-mail_0_6 was dropped, please note the manual upgrade process before changing the package to pkgs.stalwart-mail in services.stalwart-mail.package.

nomad_1_5 and nomad_1_6 were dropped, as they have reached end-of-life upstream. Evaluating them will throw an error.

The default nomad package has been updated to 1.8.x. For more information, see breaking changes for Nomad 1.8

androidndkPkgs has been updated to androidndkPkgs_26.

Android NDK version 26 and SDK version 33 are now the default versions used for cross compilation to android.

ankisyncd package and its services.ankisyncd have been removed. Use services.anki-sync-server instead.

nodePackages.vscode-css-languageserver-bin, nodePackages.vscode-html-languageserver-bin, and nodePackages.vscode-json-languageserver-bin were dropped due to an unmaintained upstream. The vscode-langservers-extracted package is a maintained drop-in replacement.

nodePackages.prisma has been replaced by prisma.

fetchNextcloudApp has been rewritten to use fetchurl rather than fetchzip. This invalidates all existing hashes, but you can restore the old behavior by passing it unpack = true.

haskell.lib.compose.justStaticExecutables now disallows references to GHC in its output by default to alert users to closure size issues caused by #164630. See “Packaging Helpers” in the Haskell section of the Nixpkgs manual for information on working around output '...' is not allowed to refer to the following paths errors caused by this change.

services.stalwart-mail now runs under the stalwart-mail system user instead of a dynamic one via DynamicUser in order to avoid automatic ownership changes on its large file store on service restart. This change requires to manually move the state directory from /var/lib/private/stalwart-mail to /var/lib/stalwart-mail, and to change the ownership of the directory and its content to stalwart-mail.

services.stalwart-mail now uses RocksDB as the default storage backend for stateVersion ≥ 24.11. It was previously using SQLite for structured data and the filesystem for blobs.

services.stargazer has been hardened to improve security, but these changes make break certain setups, particularly around traditional CGI.

services.shiori now requires the HTTP secret value SHIORI_HTTP_SECRET_KEY to be provided as an environment variable. services.shiori.environmentFile has been introduced to handle this:

# This is how a environment file can be generated:
# $ printf "SHIORI_HTTP_SECRET_KEY=%s\n" "$(openssl rand -hex 16)" > /path/to/env-file
services.shiori.environmentFile = "/path/to/env-file";

/share/nano is now only linked when programs.nano.enable is enabled.

PPD files for Utax printers were renamed (spaces replaced by underscores) in the newest foomatic-db package. Users of Utax printers might need to adapt their hardware.printers.ensurePrinters.*.model value to account for this.

sqldeveloper was dropped due to being severely out-of-date and having a dependency on JavaFX for Java 8, which we do not support.

The kvdo kernel module package was removed as it was upstreamed in kernel version 6.9, where it is now called dm-vdo.

libe57format has been updated to >= 3.0.0, which contains some backward-incompatible API changes. See the release note for more details.

gitlab deprecated support for runner registration tokens in GitLab 16.0, disabled their support in GitLab 17.0 and will ultimately remove it in GitLab 18.0 (as outlined in the documentation). After upgrading to GitLab >= 17.0, it is possible to re-enable support for registration tokens in the UI until GitLab 18.0. Refer to the manual on using registration tokens after GitLab 17.0. GitLab administrators should migrate to the new runner registration workflow with runner authentication tokens until the release of GitLab 18.0.

gitlab has been updated from 16.x to 17.x and requires postgresql >= 14.9, as stated in the documentation. Check the upgrade guide in the NixOS manual on how to upgrade your PostgreSQL installation.

gitaly (part of gitlab) is now using the bundled git package instead of pkgs.git, to maintain compatibility with GitLab.

nixos/gitlab no longer adds pkgs.git to environment.systemPackages by default.

The replay-sorcery package and module was removed as it unmaintained upstream. Consider using gpu-screen-recorder or obs-studio instead.

A few options of services.samba have been moved from extraConfig and configText to the new freeform option settings and renamed, e.g.:

zx was updated to v8, which introduces several breaking changes. See the v8 changelog for more information.

feishin removed support for Navidrome < v0.53.2 due to an API change. See the v0.10.0 release notes for more information.

services.dnscrypt-wrapper was removed, as the project has been effectively unmaintained since 2018. Moreover, the NixOS module had to rely on an abandoned version of dnscrypt-proxy v1 for the rotation of keys. To wrap a resolver with DNSCrypt, you can instead use dnsdist. See services.dnsdist.dnscrypt

The portunus package and service do not support weak password hashes anymore. If you installed Portunus on NixOS 23.11 or earlier, upgrade to NixOS 24.05 first to get support for strong password hashing. Then, follow the instructions on the upstream release notes to upgrade all existing user accounts to strong password hashes. If you need to upgrade to 24.11 without having completed the migration, consider the security implications of weak password hashes on your user accounts, and add the following to your configuration:

services.portunus.package      = pkgs.portunus.override { libxcrypt = pkgs.libxcrypt-legacy; };
services.portunus.ldap.package = pkgs.openldap.override { libxcrypt = pkgs.libxcrypt-legacy; };

The default value of services.kubernetes.kubelet.hostname is now lowercased. Explicitly set kubelet.hostname to networking.fqdnOrHostName to get back the old default behavior.

Docker now defaults to 27.x, as version 24.x stopped receiving security updates and bug fixes after February 1, 2024.

keycloak was updated to version 25, which introduces new hostname related options. See Upgrading Guide for instructions.

programs.vim.defaultEditor now only works if programs.vim.enable is enabled.

services.mautrix-meta was updated to 0.4. This release makes significant changes to the settings format. If you have custom settings you should migrate them to the new format. Unfortunately upstream provides little guidance for how to do this, but the auto-migration code may serve as a useful reference. The NixOS module should warn you if you still have any old settings configured.

The nodePackages.shout package has been removed because it was deprecated upstream in favor of thelounge. The shout top-level attribute was an alias to this package. The associated services.shout module has also been removed.

prometheus-openldap-exporter was removed, as it was unmaintained both upstream and in nixpkgs.

The indi-full package no longer contains non-free drivers. To get the old collection of drivers use indi-full-nonfree or create your own collection of drivers by overriding indi-with-drivers. E.g.: pkgs.indi-with-drivers.override {extraDrivers = with pkgs.indi-3rdparty; [indi-gphoto];}

/share/vim-plugins now only gets linked if programs.vim.enable is enabled

The services.guix module now manages trusted substitute servers declaratively. Instead of guix archive --authorize, list keys with services.guix.substituters.authorizedKeys. Default substitute servers can be set via services.guix.substituters.urls.

The tracy package no longer works on X11, since it’s moved to Wayland support, which is the intended default behavior by Tracy maintainers. X11 users have to switch to the new package tracy-x11.

gollum has been upgraded to major version 6. Please review their migration notes.

services.prometheus.exporters.minio option has been removed, as it’s upstream implementation was broken and unmaintained. Minio now has built-in Prometheus metrics exposure, which can be used instead.

The services.prometheus.exporters.tor option has been removed, as its upstream implementation was broken and unmaintained.

services.patroni.raft has been removed, as Raft has been deprecated by upstream since 3.0.0.

The jd-cli package was removed due to an inactive upstream and a dependency on the shut down JCenter JAR repository. Java decompilers already packaged in Nixpkgs include bytecode-viewer (GUI), cfr (CLI), and procyon (CLI).

The jd-gui package was removed due to an inactive upstream and a dependency on the end-of-life Gradle 6. Java decompilers already packaged in Nixpkgs include bytecode-viewer (GUI), cfr (CLI), and procyon (CLI).

services.roundcube.maxAttachmentSize will multiply the value set with 1.37 to offset overhead introduced by the base64 encoding applied to attachments.

services.mxisd has been removed as both mxisd and ma1sd are no longer maintained. Consequently, the package ma1sd has also been removed.

The rss-bridge service drops the support to load a configuration file from ${config.services.rss-bridge.dataDir}/config.ini.php. Consider using the services.rss-bridge.config option instead.

mikutter has been removed, as the package was broken and had no maintainers in nixpkgs.

xdg.portal.gtkUsePortal has been removed, as it had been deprecated for over 2 years. Using the GTK_USE_PORTAL environment variable in this manner is not intended nor encouraged by the GTK developers, but can still be done manually via environment.sessionVariables.

Support for the legacy CUPS browsing and LDAP have been removed from services.printing. If cups or ldap are in the BrowseRemoteProtocols setting in services.printing.browsedConf, it needs to be removed.

services.trust-dns has been renamed to services.hickory-dns.

services.prometheus.exporters.pgbouncer.connectionStringFile has been removed since it leaked the connection string (and thus potentially the DB password) into the cmdline of process making it effectively world-readable.

Use services.prometheus.exporters.pgbouncer.connectionEnvFile instead.

lsh and services.lshd have been removed as they had no maintainer in Nixpkgs and no upstream release in over a decade. It is recommended to migrate to openssh and services.openssh.

ceph has been upgraded to v19. See the Ceph “squid” release notes for details and recommended upgrade procedure.

services.frr has been refactored to use upstream service scripts. The per-daemon configurations have been removed in favour of an integrated-vtysh-config style config. The daemon submodules now use the daemon name (e.g. ospfd) instead of the protocol name (ospf). The daemons zebra, mgmtd and staticd are always enabled if a config is present. The vtyListenAddress and vtyListenPort options have been removed; use options or extraOptions instead, respectively.

opencv2 and opencv3 have been removed, as they are obsolete and were not used by any other package. External users are encouraged to migrate to OpenCV 4.

tvheadend package and the services.tvheadend module have been removed due to lack of maintenance in Nixpkgs and being stuck on an unmaintained version that required FFmpeg 4. Please see the related pull request #332259 if you are interested in maintaining a newer version.

antennas and services.antennas have been removed as they only work with tvheadend (see above).

system.build.brightboxImage has been removed as it no longer built and has not seen any maintenance in over 7 years (excluding tree-wide changes).

services.syncplay now exposes all currently available command-line arguments for syncplay-server as options, as well as a useACMEHost option for easy TLS setup. The systemd service now uses DynamicUser/StateDirectory and the user and group options have been deprecated.

openlens was removed. It is recommended to use lens-desktop instead.

services.dnsmasq.extraConfig has been removed, as it had been deprecated for over 2 years. This option has been replaced by services.dnsmasq.settings.

The NixOS installation media no longer support the ReiserFS or JFS file systems by default.

Minimal installer ISOs are no longer built on the small channel. Please obtain installer images from the full release channels.

The default FFmpeg version is now 7.1, and FFmpeg 5 has been removed. Please prefer using the package variants without a version suffix, or pin FFmpeg 6 or 4 if necessary for compatibility. Note that we keep old versions around only as required to support packages in the tree, and FFmpeg 4 especially should be avoided in favour of newer versions as it may be removed soon.

openssl now defaults to the latest version line 3.3.x, instead of 3.0.x before. While there should be no major code incompatibilities, newer OpenSSL versions typically strengthen the default security level. This means that you may have to explicitly allow weak ciphers, hashes and key lengths if necessary. See: OpenSSL security level documentation.

isync has been updated to version 1.5.0, which introduces some breaking changes. See the compatibility concerns for more details.

Two new packages – gpauth and gpclient from the 2.x version of the GlobalProtect-openconnect project – are added in parallel to globalprotect-openconnect. The GUI components related to the project are non-free and not packaged.

Compatible string matching for hardware.deviceTree.overlays has been changed to a more correct behavior. See below for details.

rustic was upgraded to 0.9.0, which contains breaking changes to the config file format.

pkgs.formats.ini and pkgs.formats.iniWithGlobalSection with listsAsDuplicateKeys or listToValue no longer merge non-list values into lists by default. Backwards-compatible behavior can be enabled with atomsCoercedToLists.

Atlassian Server products have been removed, as support for the Atlassian Server products ended in February 2024 and there was insufficient interest in maintaining the Atlassian Data Center replacements:

python3Packages.nose has been removed, as it has been deprecated and unmaintained for almost a decade and does not work on Python 3.12. Please switch to pytest or another test runner/framework.

dotnet-sdk, dotnet-runtime, and all other dotnet packages now use a wrapper package containing bin/dotnet, build hooks, etc. If you need to reference the underlying dotnet distribution (DOTNET_ROOT) you should use e.g. dotnet-runtime.unwrapped.

The root of dotnet distribution packages (DOTNET_ROOT) is now under e.g. ${dotnet-sdk.unwrapped}/share/dotnet instead of directly in the package root. This is consistent with packaging guidelines and more friendly for FHS environments.

dotnet-sdk, dotnet-runtime, and dotnet-aspnetcore now point to dotnet 8 rather than dotnet 6. For packages that still need dotnet 6, use dotnet-sdk_6, etc.

torq has been removed because upstreamed went closed source.

The zerocallusedregs hardening flag is enabled by default on compilers that support it.

The stackclashprotection hardening flag has been added, though disabled by default.

The pacret hardening flag has been added, though disabled by default.

cargoSha256 in rustPlatform.buildRustPackage has been deprecated in favor of cargoHash which supports SRI hashes. See buildRustPackage: Compiling Rust applications with Cargo for more information.

The vendorHash of Go packages built with buildGoModule can now be overridden with overrideAttrs. goModules, modRoot, vendorHash, deleteVendor, and proxyVendor are now passed as derivation attributes. goModules and vendorHash are no longer placed under passthru.

buildFlags/buildFlagsArray on buildGoModule have been deprecated. 24.11 is the last release where buildGoModule accepts these flags (while throwing a warning). Use the ldflags and/or tags attributes or the environment instead.

buildGoPackage has been deprecated. 24.11 is the last release with buildGoPackage available.

hareHook has been added as the language framework for Hare. From now on, it, not the hare package, should be added to nativeBuildInputs when building Hare programs.

virtualisation.docker.liveRestore has been renamed to virtualisation.docker.daemon.settings."live-restore" and turned off by default for state versions of at least 24.11.

Tailscale’s authKeyFile can now have its corresponding parameters set through config.services.tailscale.authKeyParameters, allowing for non-ephemeral unsupervised deployment and more. See Registering new nodes using OAuth credentials for the supported options.

nixosTests now provide a working IPv6 setup for VLAN 1 by default.

Kanidm can now be provisioned using the new [services.kanidm.provision] option, but requires using a patched version available via pkgs.kanidm.withSecretProvisioning.

Kanidm previously had an incorrect systemd service type, causing dependent units with an after and requires directive to start before kanidm* finished startup. The module has now been updated in line with upstream recommendations.

The kubelet configuration file can now be amended with arbitrary additional content using the services.kubernetes.kubelet.extraConfig option.

The services.seafile module was updated to major version 11.

The new option boot.binfmt.addEmulatedSystemsToNixSandbox allows you to skip adding the emulated systems to nix.settings.extra-platforms. Now you can emulate foreign binaries locally while only building them on native remote builders.

The latest available version of Nextcloud is v30 (available as pkgs.nextcloud30). The installation logic is as follows:

To facilitate dependency injection, the imgui package now builds a static archive using vcpkg’ CMake rules. The derivation now installs “impl” headers selectively instead of by a wildcard. Use imgui.src if you just want to access the unpacked sources.

The new boot.loader.systemd-boot.windows option makes setting up dual-booting with Windows on a different drive easier.

The boot.loader.raspberryPi options were marked as deprecated in 23.11 and have now been removed.

Linux 4.19 has been removed because it will reach its end of life within the lifespan of 24.11.

Unprivileged access to the kernel syslog via dmesg is now restricted by default. Users wanting to keep an unrestricted access to it can set boot.kernel.sysctl."kernel.dmesg_restrict" = false.

The i18n.inputMethod module introduces two new properties: enable and type, for declaring whether to enable an alternative input method and defining which input method respectfully. The options available in type are the same as the existing enabled option. enabled is now deprecated, and will be removed in a future release.

security.pam.u2f now uses freeform options; all module options are now configurable through security.pam.u2f.settings.

mikutter was removed as the package was broken and had no maintainers.

services.getty.autologinOnce was added to limit the automatic login to once per boot and on the first tty only. When using full disk encryption, this option allows to unlock the system without retyping the passphrase while keeping the other ttys protected.

Gollum was upgraded to major version 6. Read their migration notes.

The hooks yarnConfigHook and yarnBuildHook were added. These should replace yarn2nix.mkYarnPackage and other yarn2nix related tools. The motivation to get rid of yarn2nix tools is the fact that they are too complex and hard to maintain, and they rely upon too much Nix evaluation which is problematic if import-from-derivation is not allowed (see more details at #296856. The transition from mkYarnPackage to yarn{Config,Build}Hook is tracked at #324246.

services.timesyncd.servers now defaults to null, allowing systemd-timesyncd to use NTP servers advertised by DHCP.

services.timesyncd.fallbackServers was added and defaults to networking.timeServers.

Cinnamon has been updated to 6.2. Please check upstream announcement for more details. Following Mint 22 defaults, the Cinnamon module no longer ships geary and hexchat by default.

zfs.latestCompatibleLinuxPackages is deprecated and is now pointing at the default kernel. If using the stable LTS kernel (default linuxPackages is not possible then you must explicitly pin a specific kernel release. For example, boot.kernelPackages = pkgs.linuxPackages_6_6. Please be aware that non-LTS kernels are likely to go EOL before ZFS supports the latest supported non-LTS release, requiring manual intervention.

The shadowstack hardening flag has been added, though disabled by default.

writeReferencesToFile has been removed after its deprecation in 24.05. Use the trivial build helper writeClosure instead.

xxd is now provided by the tinyxxd package rather than vim.xxd to reduce closure size and vulnerability impact. Since it has the same options and semantics as Vim’s xxd utility, there is no user impact. Vim’s xxd remains available as the vim.xxd package.

restic module now has an option for inhibiting system sleep while backups are running, defaulting to off (not inhibiting sleep). Available as services.restic.backups.<name>.inhibitsSleep.

Mattermost has been updated from 9.5 to 9.11 ESR. See the changelog for more details.

cargo-tauri.hook was introduced to help users build Tauri projects. It is meant to be used alongside rustPlatform.buildRustPackage and Node hooks such as npmConfigHook, pnpm.configHook, and the new yarnConfig

power.ups now powers off UPSs during a power outage event. This saves UPS battery and ensures that host(s) get back up again when power comes back, even in the scenario when the UPS would have had enough capacity to keep power on during the whole power outage. If you like the old behaviour of keeping the UPSs on (and emptying the battery) after the host(s) have shut down, and risk not getting a power cycle event to get the host(s) back up, set power.ups.upsmon.settings.POWERDOWNFLAG = null;.

nixos-firewall-tool now supports nftables in addition to iptables and is installed by default when NixOS firewall is enabled.

Support for runner registration tokens has been deprecated in gitlab-runner 15.6 and is expected to be removed in gitlab-runner 18.0. Configuration of existing runners should be changed to using runner authentication tokens by configuring services.gitlab-runner.services.<name>.authenticationTokenConfigFile instead of the former services.gitlab-runner.services.<name>.registrationConfigFile option.

iproute2 now has libbpf support.

If you use extensions that are not packaged in nixpkgs, please review whether it still works with the current settings and adjust accordingly if needed.

nix.channel.enable = false no longer implies nix.settings.nix-path = []. Since Nix 2.13, a nix-path set in nix.conf cannot be overridden by the NIX_PATH configuration variable.

ZFS now imports its pools in postResumeCommands rather than postDeviceCommands. If you had postDeviceCommands scripts that depended on ZFS pools being imported, those now need to be in postResumeCommands.

services.automatic-timezoned.enable = true will now set time.timeZone = null. This is to avoid silently shadowing a user’s explicitly defined timezone without recognition on the user’s part.

services.localtimed.enable = true will now set time.timeZone = null. This is to avoid silently shadowing a user’s explicitly defined timezone without recognition on the user’s part.

qgis and qgis-ltr are now built without grass by default. grass support can be enabled with qgis.override { withGrass = true; }.

virtualisation.incus module gained new incus-user.service and incus-user.socket systemd units. It is now possible to add a user to incus group instead of incus-admin for increased security.

freecad now supports addons and custom configuration in nix-way, which can be used by calling freecad.customize.

The default kernel package has been updated from 6.1 to 6.6. All supported kernels remain available.

For each supporting version of the Linux kernel, firmware blobs are compressed with zstd. For firmware blobs this means an increase of 4.4% in size, however a significantly higher decompression speed.

NixOS now installs a stub ELF loader that prints an informative error message when users attempt to run binaries not made for NixOS.

On flake-based NixOS configurations using nixpkgs.lib.nixosSystem, NixOS will automatically set NIX_PATH and the system-wide flake registry (/etc/nix/registry.json) to point <nixpkgs> and the unqualified flake path nixpkgs to the version of nixpkgs used to build the system.

This makes nix run nixpkgs#hello and nix-build '<nixpkgs>' -A hello work out of the box with no added configuration, reusing dependencies already on the system.

This may be undesirable if Nix commands are not going to be run on the built system since it adds nixpkgs to the system closure. For such closure-size-constrained non-interactive systems, this setting should be disabled.

To disable it, set nixpkgs.flake.setNixPath and nixpkgs.flake.setFlakeRegistry to false.

NixOS AMIs are now uploaded regularly to a new AWS Account. Instructions on how to use them can be found on https://nixos.github.io/amis. We are working on integrating the data into the NixOS homepage. The list in nixos/modules/virtualisation/amazon-ec2-amis.nix will stop being updated and will be removed in the future.

It is now possible to have a completely perlless system (i.e. a system without perl). Previously, the NixOS activation depended on two perl scripts which can now be replaced via an opt-in mechanism. To make your system perlless, you can use the new perlless profile:

{ modulesPath, ... }: {
  imports = [ "${modulesPath}/profiles/perlless.nix" ];
}

Cinnamon has been updated to 6.0. Please be aware that the Wayland session is still experimental in this release and could potentially affect Xorg sessions. We suggest a reboot when switching between sessions.

GNOME has been updated to 46 “Kathmandu”. Refer to the release notes for more details. Notably this release brings experimental VRR support, default GTK renderer changes and WebDAV support in Online Accounts. This release we have also stopped including the legacy and unsupported Adwaita-Dark theme by default.

Lomiri (formerly known as Unity8) desktop mode, using Mir 2.x to function as a Wayland compositor, is now available and can be installed with services.desktopManager.lomiri.enable = true. Note that some core applications, services and indicators have yet to be packaged, and some functions may remain incomplete, but the base experience should be there.

LXQt has been updated to 2.0, which is based on Qt 6 and features Wayland support for many applications.

MATE has been updated to 1.28.

Plasma 6 is now available and can be installed with services.desktopManager.plasma6.enable = true;. Plasma 5 will likely be deprecated in the next release (24.11). Note that Plasma 6 runs as Wayland by default, and the X11 session needs to be explicitly selected if necessary.

Anki Sync Server, the official sync server built into recent versions of Anki. Available as services.anki-sync-server. The pre-existing services.ankisyncd has been marked deprecated and will be dropped after 24.05 due to lack of maintenance of the ankisyncd software.

ALVR, a VR desktop streamer. Available as programs.alvr.

AppImage, a tool to package desktop applications, now has a binfmt option to support running AppImages seamlessly on NixOS. Available as programs.appimage.binfmt.

armagetronad, a mid-2000s 3D lightcycle game widely played at iD Tech Camps. You can define multiple servers using services.armagetronad.<server>.enable.

BenchExec, a framework for reliable benchmarking and resource measurement, available as programs.benchexec, as well as related programs CPU Energy Meter, available as programs.cpu-energy-meter, and PQoS Wrapper, available as programs.pqos-wrapper.

Bluemap, a 3D minecraft map renderer. Available as services.bluemap.

clatd, a CLAT / SIIT-DC Edge Relay implementation for Linux.

Clevis, a pluggable framework for automated decryption, used to unlock encrypted devices in initrd. Available as boot.initrd.clevis.enable.

CommaFeed, a Google Reader-inspired self-hosted RSS reader. Available as services.commafeed.

davis, a simple CardDav and CalDav server inspired by Baïkal. Available as services.davis.

db-rest, a wrapper around Deutsche Bahn’s internal API for public transport data. Available as services.db-rest.

dnsproxy, a simple DNS proxy with DoH, DoT, DoQ and DNSCrypt support. Available as services.dnsproxy.

FCast Receiver, an open-source alternative to Chromecast and AirPlay. Available as programs.fcast-receiver.

FileSender, a file sharing software. Available as services.filesender.

Firefly-iii, a free and open source personal finance manager. Available as services.firefly-iii.

Flarum, a delightfully simple discussion platform for your website. Available as services.flarum.

fritz-exporter, a Prometheus exporter for extracting metrics from FRITZ! devices. Available as services.prometheus.exporters.fritz.

GNS3, a network software emulator. Available as services.gns3-server.

go-camo, a secure image proxy server. Available as services.go-camo.

Guix, a functional package manager inspired by Nix. Available as services.guix.

Handheld Daemon, support for gaming handhelds like the Legion Go, ROG Ally, and GPD Win. Available as services.handheld-daemon.

hebbot, a Matrix bot to generate “This Week in X” like blog posts. Available as services.hebbot.

inadyn, a Dynamic DNS client with built-in support for multiple providers. Available as services.inadyn.

intel-gpu-tools, tools for development and testing of the Intel DRM driver. Available as hardware.intel-gpu-tools.

isolate, a sandbox for securely executing untrusted programs. Available as security.isolate.

Jottacloud Command-line Tool, a CLI for the Jottacloud cloud storage provider. Available as services.jotta-cli.

keto, a permission & access control server, the first open source implementation of Zanzibar: Google’s Consistent, Global Authorization System.

manticoresearch, easy to use open source fast database for search. Available as services.manticore.

maubot, a plugin-based Matrix bot framework. Available as services.maubot.

mautrix-meta, a Matrix <-> Facebook and Matrix <-> Instagram hybrid puppeting/relaybot bridge. Available as services.mautrix-meta.

mautrix-signal, a Matrix-Signal puppeting bridge. Available as services.mautrix-signal.

Mealie, a self-hosted recipe manager and meal planner with a RestAPI backend and a reactive frontend application built in NuxtJS for a pleasant user experience for the whole family. Available as services.mealie.

MollySocket which allows getting Signal notifications via UnifiedPush.

microsocks, a tiny, portable SOCKS5 server with very moderate resource usage. Available as services.microsocks.

Mihomo, a rule-based proxy in Go. Available as services.mihomo.enable.

Monado, an open source XR runtime. Available as services.monado.

Netbird, an open-source VPN management platform, now has a self-hosted management server. Available as services.netbird.server.

nh, yet another Nix CLI helper. Available as programs.nh.

oink, a dynamic DNS client for Porkbun. Available as services.oink.

ollama, server for running large language models locally.

nextjs-ollama-llm-ui, light-weight frontend server to chat with Ollama models through a web app.

ownCloud Infinite Scale Stack, a modern and scalable rewrite of ownCloud.

PhotonVision, a free, fast, and easy-to-use computer vision solution for the FIRST® Robotics Competition.

ping_exporter, a Prometheus exporter for ICMP echo requests. Available as services.prometheus.exporters.ping.

Pretix, an open source ticketing software for events. Available as services.pretix.

pretalx, a conference planning tool. Available as services.pretalx.

private-gpt, a service to interact with your documents using the power of LLMs, 100% privately, no data leaks. Available as services.private-gpt.

Prometheus DNSSEC Exporter: check for validity and expiration in DNSSEC signatures and expose metrics for Prometheus. Available as services.prometheus.exporters.dnssec.

prometheus-nats-exporter, a Prometheus exporter for NATS. Available as services.prometheus.exporters.nats.

pyLoad, a FOSS download manager written in Python. Available as services.pyload.

Python Matter Server, a Matter Controller Server exposing websocket connections for use with other services, notably Home Assistant. Available as services.matter-server.

RustDesk, a full-featured open source remote control alternative for self-hosting and security with minimal configuration. Alternative to TeamViewer. Available as services.rustdesk-server.

ryzen-monitor-ng, a desktop AMD CPU power monitor and controller, similar to Ryzen Master but for Linux. Available as programs.ryzen-monitor-ng.

ryzen-smu, Linux kernel driver to expose the SMU (System Management Unit) for certain AMD Ryzen Processors. Includes the userspace program monitor_cpu. Available at hardward.cpu.amd.ryzen-smu.

Scrutiny, a S.M.A.R.T monitoring tool for hard disks with a web frontend. Available as services.scrutiny.

SimpleSAMLphp, an application written in native PHP that deals with authentication (SQL, .htpasswd, YubiKey, LDAP, PAPI, Radius). Available as services.simplesamlphp.

systemd’s gateway, upload, and remote services, which provide ways of sending journals across the network. Enable using services.journald.gateway, services.journald.upload, and services.journald.remote.

systemd-lock-handler, a bridge between logind D-Bus events and systemd targets. Available as services.systemd-lock-handler.enable.

rspamd-trainer, script triggered by a helper which reads mails from a specific mail inbox and feeds them into rspamd for spam/ham training.

Sunshine, a self-hosted game stream host for Moonlight. Available as services.sunshine.

Suwayomi Server, a free and open source manga reader server that runs extensions built for Tachiyomi. Available as services.suwayomi-server.

TigerBeetle, a distributed financial accounting database designed for mission critical safety and performance. Available as services.tigerbeetle.

transfer-sh, a tool that supports easy and fast file sharing from the command-line. Available as services.transfer-sh.

TuxClocker, a hardware control and monitoring program. Available as programs.tuxclocker.

Uni-Sync, a synchronization tool for Lian Li Uni Controllers. Available as hardware.uni-sync.

wastebin, a pastebin server written in rust. Available as services.wastebin.

watchdogd, a system and process supervisor using watchdog timers. Available as services.watchdogd.

WiVRn, an OpenXR streaming application. Available as services.wivrn.

Workout-tracker, a workout tracking web application for personal use.

wyoming-satellite, a voice assistant satellite for Home Assistant using the Wyoming protocol. Available as services.wyoming.satellite.

xdg-terminal-exec, the proposed Default Terminal Execution Specification.

Convenience options for amdgpu, open source driver for Radeon cards, is now available under hardware.amdgpu.

ydotool, a generic command-line automation tool now has a module. Available as programs.ydotool.

your_spotify, a self hosted Spotify tracking dashboard. Available as services.your_spotify

RKE2, also known as RKE Government, is Rancher’s next-generation Kubernetes distribution. Available as services.rke2.

akkoma now requires explicitly setting the base URL for uploaded media (settings."Pleroma.Upload".base_url), as well as for the media proxy if enabled (settings."Media"). This is recommended to be a separate (sub)domain to the one Akkoma is hosted at. See here for more details.

appimageTools.wrapAppImage now creates the binary at $out/bin/${pname} rather than $out/bin/${pname}-${version}, which will break downstream workarounds.

apptainer and singularity now prioritize system-wide PATH over those constructed from dependent packages when searching for third-party utilities. The PATH to search for third-party utilities, known as defaultPath inside Apptainer/Singularity source code, is now constructed from the following sources, ordered by their precedence:

This change is required to enable Sylabs SingularityCE (singularity) to run images, as it requires a fusermount3 commant with the SUID bit set.

newuidmapPath and newgidmapPath arguments are deprecated in favour of systemBinPaths. Their support will be removed in future releases.

programs.singularity.systemBinPaths option is introduced to specify the systemBinPaths argument of the overridden package. It includes "/run/wrappers/bin" even if specified empty.

programs.singularity.enableFakeroot option is deprecated and has no effect. --fakeroot support is now always enabled as long as programs.singularity.systemBinPaths is not forcefully overridden.

azure-cli now has extension support. For example, to install the aks-preview extension, use

environment.systemPackages = [
  (azure-cli.withExtensions [ azure-cli.extensions.aks-preview ])
];

To make the azure-cli immutable and prevent clashes in case azure-cli is also installed via other package managers, some configuration files were moved into the derivation. This can be disabled by overriding withImmutableConfig = false when building azure-cli.

boot.supportedFilesystems and boot.initrd.supportedFilesystems are now attribute sets instead of lists. Assignment from lists as done previously is still supported, but checking whether a filesystem is enabled must now by done using supportedFilesystems.fs or false instead of using lib.elem "fs" supportedFilesystems as was done previously.

buildGoModule now throws an error when vendorHash is not specified. vendorSha256, deprecated in Nixpkgs 23.11, is now ignored and is no longer a vendorHash alias.

chromium and ungoogled-chromium had a long-standing issue regarding Widevine DRM handling in nixpkgs fixed. chromium now no longer automatically downloads Widevine when encountering DRM protected content. To be able to play DRM protected content in chromium, you now have to explicitly opt-in as originally intended using chromium.override { enableWideVine = true; }. This override was added almost 10 years ago.

craftos-pc package has been updated to v2.8, which includes breaking changes.

cryptsetup has been upgraded from 2.6.1 to 2.7.0. Cryptsetup is a critical component enabling LUKS-based (but not only) full disk encryption. Take the time to review the release notes. One of the highlights is that it is now possible to use hardware OPAL-based encryption of your disk with cryptsetup. It has a lot of caveats, see the above notes for the full details.

crystal package has been updated to 1.11.x, which has some breaking changes. Refer to crystal’s changelog for more information. (v1.10, v1.11)

cudaPackages package scope has been updated to cudaPackages_12.

cudaPackages.autoAddOpenGLRunpathHook and cudaPackages.autoAddDriverRunpath have been deprecated for pkgs.autoAddDriverRunpath. Functionality has not changed, but the setuphook has been renamed and moved to the top-level package scope.

cudaPackages.cudatoolkit has been deprecated and replaced with a symlink-based wrapper for the splayed redistributable CUDA packages. The wrapper only includes tools and libraries necessary to build common packages such as tensorflow. The original runfile-based cudatoolkit is still available as cudatoolkit-legacy-runfile.

cudaPackages.nsight_systems now has most vendored third-party libraries removed, though we now only ship it for cudaPackages_11_8 and later, due to outdated dependencies. Users comfortable with the vendored dependencies may use overrideAttrs to amend the postPatch phase and the meta.broken correspondingly. Alternatively, one could package the deprecated boost170 locally, as required for cudaPackages_11_4.nsight_systems.

cudaPackages.autoFixElfFiles has been deprecated for pkgs.autoFixElfFiles. Functionality has not changed, but the setuphook has been renamed and moved to the top-level package scope.

davfs2’s services.davfs2.extraConfig setting has been deprecated and converted to the free-form type option named services.davfs2.settings according to RFC42.

dwarf-fortress has been updated to version 50, which is identical to the version on Steam, but without the paid elements like tilepacks. dfhack and Dwarf Therapist still work, and older versions are still packaged in case you’d like to roll back. Note that DF 50 saves will not be compatible with DF 0.47 and earlier. See Bay 12 Games for more details on what’s new in Dwarf Fortress.

erlang-ls package no longer ships the els_dap binary as of v0.51.0.

erlang_node_short_name, erlang_node_name: port and options configuration parameters are gone, and have been replaced with an environment parameter. Use the appropriate environment variables inside environment to configure the service instead.

firefox-devedition, firefox-beta, firefox-esr executable file names for now match their package names, which is consistent with the firefox-*-bin packages. The desktop entries are also updated so that you can have multiple editions of firefox in your app launcher.

gauge now supports installing plugins using Nix. For the old imperative approach, switch to gauge-unwrapped. You can load plugins from an existing gauge manifest file using gauge.fromManifest ./path/to/manifest.json or specify plugins in Nix using gauge.withPlugins (p: with p; [ js html-report xml-report ]).

gitea has been updated to 1.21, which introduces several breaking changes, including:

git-town was updated from version 11 to 13. See the changelog for breaking changes.

gonic has been updated to v0.16.4. Config now requires playlists-path to be set. See the rest of the v0.16.0 release notes for more details.

go-ethereum has been updated to v1.14.3. Geth v1.14.0 introduced a brand new live-tracing feature, which required a number of breaking internal API changes. If you had your own native tracers implemented before this change, the changelog contains the necessary steps needed to update your old code for the new APIs. Geth v1.14.0 drops support for running pre-merge networks (#29169). It also stops automatically constructing the pending block (#28623), removes support for filtering pending logs, switched to using Go v1.22 by default (#28946), which means we’ve dropped support for Go v1.20. See the 1.14.0 release notes for more details.

grafana-loki has been updated to 3.0.0, which includes breaking changes.

gtest package has been updated past v1.13.0, which requires C++14 or higher.

hare may now be cross-compiled. For that to work, however, haredoc needed to stop being built together with it. Thus, the latter is now its own package with the name of haredoc.

himalaya has been updated to v1.0.0-beta.4, which introduces breaking changes. Check out the release note for details.

halloy has been updated to 2024.5, which introduced a breaking change by switching the config format from YAML to TOML. See https://github.com/squidowl/halloy/releases/tag/2024.5 for details.

hvm was updated to version 2.

icu no longer includes install-sh and mkinstalldirs in the shared folder.

idris2 was updated to v0.7.0. This version introduces breaking changes. Check out the changelog for details.

inetutils now has a lower priority to avoid shadowing the commonly-used util-linux. If one wishes to restore the default priority, simply use lib.setPrio 5 inetutils or override with meta.priority = 5.

jdt-language-server package now uses upstream’s provided python wrapper instead of our own custom wrapper. This results in the following breaking and notable changes:

julia environments can now be built with arbitrary packages from the ecosystem using the .withPackages function. For example: julia.withPackages ["Plots"].

k3s has been updated to version v1.30, previous supported versions are available under release-specific names (e.g. k3s_1_27, k3s_1_28, and k3s_1_29) in order to help you migrate to the latest supported version. See changelog and upgrade notes for more information.

k9s was updated to v0.31. There have been various breaking changes in the config file format, check out the changelog of v0.29, v0.30 and v0.31 for details. It is recommended to back up your current configuration and let k9s recreate the new base configuration.

kanata package has been updated to v1.6.1, which includes breaking changes. Check out the changelog of v1.5.0 and v1.6.0 for details.

linuxPackages_testing_bcachefs is now fully deprecated by linuxPackages_latest, and is therefore no longer available.

livebook package is now built as a mix release instead of an escript. This means that configuration now has to be done using environment variables instead of command line arguments. This has the further consequence that the livebook service configuration has changed.

lua interpreters default LUA_PATH and LUA_CPATH are not overridden by nixpkgs anymore, we patch LUA_ROOT instead which is more respectful to upstream.

luarocks-packages-updater’s .csv format, used to define lua packages to be updated, has changed: src (URL of a git repository) has now become rockspec (URL of a rockspec) to remove ambiguity regarding which rockspec to use and simplify implementation.

mkosi was updated to v22. Parts of the user interface have changed. Consult the release notes of v19, v20, v21 and v22 for a list of changes.

mongodb-4_4 has been removed as it has reached end of life. Consequently, unifi7 and unifi8 now use MongoDB 5.0 by default.

mongodb-5_0 and newer requires a cpu with the AVX instruction set to run.

neo4j has been updated to version 5. You may want to read the release notes for Neo4j 5.

netbox was updated to v3.7. services.netbox.package still defaults to v3.6 if stateVersion is earlier than 24.05. Refer to upstream’s breaking changes for v3.7.0 and upgrade NetBox by changing services.netbox.package. Database migrations will be run automatically.

network-interfaces.target system target was removed as it has been deprecated for a long time. Use network.target instead.

networking.iproute2.enable now does not set environment.etc."iproute2/rt_tables".text.

Setting environment.etc."iproute2/{CONFIG_FILE_NAME}".text will override the whole configuration file instead of appending it to the upstream configuration file.

CONFIG_FILE_NAME includes bpf_pinning, ematch_map, group, nl_protos, rt_dsfield, rt_protos, rt_realms, rt_scopes, and rt_tables.

nextcloud26 has been removed since it’s not maintained anymore by upstream. The latest available version of Nextcloud is now v29 (available as pkgs.nextcloud29). The installation logic is as follows:

nitter requires a guest_accounts.jsonl to be provided as a path or loaded into the default location at /var/lib/nitter/guest_accounts.jsonl. See Guest Account Branch Deployment for details.

nixVersions.unstable was removed. Instead the following attributes are provided:

nomad has been updated - note that HashiCorp recommends updating one minor version at a time. Please check their upgrade guide for information on safely updating clusters and potential breaking changes.

nvtop family of packages was reorganized into a nested attrset. nvtop has been renamed to nvtopPackages.full, and all nvtop-{amd,nvidia,intel,msm} packages are renamed to nvtopPackages.{amd,nvidia,intel,msm}.

openssh, openssh_hpn and openssh_gssapi are now compiled without support for the DSA signature algorithm as it is being deprecated upstream. Users still relying on DSA keys should consider upgrading to another signature algorithm. However, for the time being it is possible to restore DSA key support using override to set dsaKeysSupport = true.

optparse-bash is now dropped due to upstream inactivity. Alternatives available in Nixpkgs include argc, argbash, bashly and gum, to name a few.

paperless’ services.paperless.extraConfig setting has been removed and converted to the free-form type and option named services.paperless.settings.

pdns was updated to version v4.9.x, which introduces breaking changes. Check out the Upgrade Notes for details.

percona-server now follows the same two-fold release cycle as Oracle MySQL and provides a Long-Term-Support (LTS) in parallel with a continuous-delivery Innovation release. percona-server defaults to percona-server_lts, will be backed by the same release branch throughout the lifetime of this stable NixOS release, and is still available under the versioned attribute percona-server_8_0. The percona-server_innovation releases however have support periods shorter than the lifetime of this NixOS release and will continuously be updated to newer Percona releases. Note that Oracle considers the Innovation releases to be production-grade, but each release might include backwards-incompatible changes, even in its on-disk format. The same release scheme is applied to the supporting percona-xtrabackup tool as well.

pipewire and wireplumber modules have removed support for using environment.etc."pipewire/..." and environment.etc."wireplumber/...". Use services.pipewire.extraConfig or services.pipewire.configPackages for PipeWire and services.pipewire.wireplumber.configPackages for WirePlumber instead.

power.ups now generates upsd.conf, upsd.users and upsmon.conf automatically from a set of new configuration options. This breaks compatibility with existing power.ups setups where these files were created manually. Back up these files before upgrading NixOS.

programs.nix-ld.libraries no longer sets baseLibraries via the option’s default but in config and now merges any additional libraries with the default ones. This means that lib.mkForce must be used to clear the list of default libraries.

screen’s module has been cleaned, and will now require you to set programs.screen.enable in order to populate screenrc and add the program to the environment.

security.acme.defaults.server now has a default value instead of null. This effectively uses the same server, the Let’s Encrypt production server, but makes the default explicit, instead of relying on the Lego default.

A side effect of this is that the directory in which account data is stored changes and the ACME module will request a new account and new certificates for all domains. This may cause issues if you pin an acccounturl in a CAA DNS record. To avoid this, you may set security.acme.defaults.server = null to keep the old hashes.

security.pam.sshAgentAuth.enable now requires services.openssh.authorizedKeysFiles to be non-empty, which is the case when services.openssh.enable is true. Previously, pam_ssh_agent_auth silently failed to work.

security.pam.enableSSHAgentAuth was replaced by the sshAgentAuth attrset, and only authorized_keys files listed in sshAgentAuth.authorizedKeysFiles are trusted, defaulting to /etc/ssh/authorized_keys.d/%u.

services.archisteamfarm no longer uses the abbreviation asf for its state directory (/var/lib/asf), user and group (both asf). Instead the long name archisteamfarm is used. Configurations with system.stateVersion 23.11 or earlier, default to the old stateDirectory until the 24.11 release and must either set the option explicitly or move the data to the new directory.

frr was updated to 10.0, which introduces the default of enforce-first-as for BGP. Please disable again if needed.

services.aria2.rpcSecret has been replaced with services.aria2.rpcSecretFile. This was done so that secrets aren’t stored in the world-readable Nix store. To migrate, you will have to create a file with the same exact string, and change your module options to point to that file. For example, services.aria2.rpcSecret = "mysecret" becomes services.aria2.rpcSecretFile = "/path/to/secret_file" where the file secret_file contains the string mysecret.

services.avahi.nssmdns was split into services.avahi.nssmdns4 and services.avahi.nssmdns6 which enable the mDNS NSS switches for IPv4 and IPv6 respectively. Since most mDNS responders only register IPv4 addresses, most users want to keep the IPv6 support disabled to avoid long timeouts.

services.frp.settings now generates the frp configuration file in TOML format as recommended by upstream, instead of the legacy INI format. This has also introduced other changes in the configuration file structure and options:

services.hledger-web.capabilities options has been replaced by a new option services.hledger-web.allow.

services.homepage-dashboard now takes its configuration using native Nix expressions, rather than dumping templated configurations into /var/lib/homepage-dashboard where they were previously managed manually. There are now new options which allow the configuration of bookmarks, services, widgets and custom CSS/JS natively in Nix.

services.invidious.settings.db.user, the default database username has changed from kemal to invidious. Setups involving an externally-provisioned database (i.e. services.invidious.database.createLocally == false) should adjust their configuration accordingly. The old kemal user will not be removed automatically even when the database is provisioned automatically.(https://github.com/NixOS/nixpkgs/pull/265857).

services.oauth2_proxy was renamed to services.oauth2-proxy. Also the corresponding service, user and group were renamed.

services.smokeping now has an option webService. When enabled, smokeping is now served via nginx instead of thttpd. This change brings the following consequences:

services.neo4j.allowUpgrade was removed and no longer has any effect. Neo4j 5 supports automatic rolling upgrades.

services.nextcloud has the following options moved into services.nextcloud.settings and renamed to match the name from Nextcloud’s config.php:

services.nginx will no longer advertise HTTP/3 availability automatically. This must now be manually added, preferably to each location block. Example:

{
  locations."/".extraConfig = ''
    add_header Alt-Svc 'h3=":$server_port"; ma=86400';
  '';
  locations."^~ /assets/".extraConfig = ''
    add_header Alt-Svc 'h3=":$server_port"; ma=86400';
  '';
}

services.pgbouncer now has systemd support enabled and will log to journald. The default setting for services.pgbouncer.logFile is now null to disable logging to a separate log file.

services.postgresql.ensureUsers._.ensurePermissions has been removed as it is not declarative and is broken with newer postgresql versions. Consider using services.postgresql.ensureUsers.*.ensureDBOwnership instead or a tool that is more suited for managing the data inside a postgresql database.

services.redis.vmOverCommit now defaults to true and no longer enforces Transparent Hugepages (THP) to be disabled. Redis only works with THP configured to madvise which is the kernel’s default.

services.resolved.fallbackDns

services.vikunja systemd service now uses vikunja as dynamic user instead of vikunja-api. Database users might need to be changed.

services.vikunja.setupNginx setting has been removed. Users now need to set up the webserver configuration on their own with a proxy pass to the vikunja service.

services.vmagent module deprecates dataDir, group and user settings in favor of the systemd-provided CacheDirectory and DynamicUser.

services.vmagent.remoteWriteUrl setting has been renamed to services.vmagent.remoteWrite.url and now defaults to null.

services.zope2 has been removed, as zope2 is unmaintained and was relying on Python 2.

spark2014 has been renamed to gnatprove. A version of gnatprove matching different GNAT versions is available from the different gnatPackages sets.

stalwart-mail has been updated to v0.5.3, which includes breaking changes.

system.etc.overlay.enable option was added. If enabled, /etc is mounted via an overlayfs instead of being created by a custom perl script.

system.forbiddenDependenciesRegex has been renamed to system.forbiddenDependenciesRegexes and now has the type of listOf string instead of string to accept multiple regexes.

systemd.oomd module behavior has changed:

systemd.sysusers.enable option was added. If enabled, users and groups are created with systemd-sysusers instead of with a custom perl script.

teleport has been upgraded from major version 14 to major version 15. Refer to upstream upgrade instructions and release notes for v15.

unifiLTS, unifi5 and unifi6 have been removed, as they require MongoDB versions which are end-of-life. All these versions can be upgraded to unifi7 directly.

unrar was updated to v7. See changelog for more information.

virtualisation.docker.enableNvidia and virtualisation.podman.enableNvidia options are deprecated. hardware.nvidia-container-toolkit.enable should be used instead. This option will expose GPUs on containers with the --device CLI option. This is supported by Docker 25, Podman 3.2.0 and Singularity 4. Any container runtime that supports the CDI specification will take advantage of this feature.

virtialisation.incus now defaults to the newly-added incus-lts release (v6.0.x). Users who wish to continue using the non-LTS release will need to set virtualisation.incus.package = pkgs.incus. Stable release users are encouraged to stay on the LTS release as non-LTS releases will by default not be backported.

woodpecker-* packages have been updated to v2 which includes breaking changes.

wpaperd has been updated to 1.0.1, which has a breaking change: previous version 0.3.0 had 2 different configuration files, one for wpaperd and one for the wallpapers. Remove the former and move the latter (wallpaper.toml) to config.toml.

writeReferencesToFile is deprecated in favour of the new trivial build helper writeClosure. The latter accepts a list of paths and has an unambiguous name and cleaner implementation.

xfsprogs was updated to version 6.6.0, which enables reverse mapping (rmapbt) and large extent counts (nrext64) by default. Support for these features was added in kernel 4.9 and 5.19 and nrext64 was deemed stable in kernel 6.5. Format your filesystems with mkfs.xfs -i nrext64=0, if they need to be readable by GRUB2 before 2.12 or kernels older than 5.19.

xxd has been moved from vim default output to its own output to reduce closure size. The canonical way to reference it across all platforms is unixtools.xxd.

youtrack was bumped to 2023.3. The update is not performed automatically, it requires manual interaction. See the YouTrack section in the manual for details.

Ada packages (libraries and tools) have been moved into the gnatPackages scope. gnatPackages uses the default GNAT compiler, gnat12Packages and gnat13Packages use the respective matching compiler version.

Paths provided as restartTriggers and reloadTriggers for systemd units will now be copied into the Nix store to make the behavior consistent. Previously, restartTriggers = [ ./config.txt ], if defined in a flake, would trigger a restart when any part of the flake changed; and if not defined in a flake, would never trigger a restart even if the contents of config.txt changed.

A warning has been added for services that are after = [ "network-online.target" ] but do not depend on it (e.g. using wants), because the dependency that multi-user.target has on network-online.target is planned for removal.

switch-to-configuration does not directly call systemd-tmpfiles anymore. Instead, the new artificial sysinit-reactivation.target is introduced which allows to restart multiple services that are ordered before sysinit.target and respect the ordering between the services.

services.prometheus.exporters.snmp’s configuration format changed with release 0.23.0. The module now includes an optional config check, that is enabled by default, to make the change obvious before any deployment. More information about the configuration syntax change is available in the upstream repository.

addDriverRunpath has been added to facilitate the deprecation of the old addOpenGLRunpath setuphook. This change is motivated by the evolution of the setuphook to include all hardware acceleration.

appimage, appimageTools.wrapAppImage and buildFHSEnvBubblewrap now properly accept pname and version.

bacula now allows to configure TLS for encrypted communication.

boot.initrd.network.ssh.authorizedKeyFiles is a new option in the initrd ssh daemon module, for adding authorized keys via list of files.

boot.kernel.sysctl."net.core.wmem_max" changed from a string to an integer because of the addition of a custom merge option (taking the highest value defined to avoid conflicts between 2 services trying to set that value), just as boot.kernel.sysctl."net.core.rmem_max" since 22.11.

boot.loader.systemd-boot.xbootldrMountPoint is a new option for setting up a separate XBOOTLDR partition to store boot files. Useful on systems with a small EFI System partition that cannot be easily repartitioned.

boot.loader.systemd-boot will now verify that efiSysMountPoint (and xbootldrMountPoint if configured) are mounted partitions.

buildDubPackage can now be used to build Programs written in D using the dub build system and package manager. See the D section in the manual for more information.

castopod has some migration actions to be taken in case of a S3 setup. Some new features may also need some manual migration actions. See https://code.castopod.org/adaures/castopod/-/releases for more information.

documentation.man.mandoc now, by default, uses MANPATH to set the directories where mandoc will search for manual pages. This enables mandoc to find manual pages in Nix profiles. To set the manual search paths via the mandoc.conf configuration file like before, use documentation.man.mandoc.settings.manpath instead.

drbd out-of-tree Linux kernel driver has been added in version 9.2.7. With it the DRBD 9.x features can be used instead of the 8.x features provided by the 8.4.11 in-tree driver.

garage has been updated to v1.x.x. Users should read the upstream release notes and follow the documentation when changing over their services.garage.package and performing this manual upgrade.

hardware.pulseaudio module now sets permissions of pulse user home directory to 755 when running in systemWide mode. It fixes issue 114399.

kavita has been updated to 0.8.0, requiring a manual forced library scan on all libraries for migration. Refer to upstream’s release notes for details.

krb5 module has been rewritten and moved to security.krb5, moving all options but security.krb5.enable and security.krb5.package into security.krb5.settings.

libass now uses the native CoreText backend on Darwin, which may fix subtitle rendering issues with mpv, ffmpeg, etc.

libjxl version was bumped from 0.8.2 to 0.9.1 dropped support for the butteraugli API. You will no longer be able to set enableButteraugli on libaom.

lilypond and denemo are now compiled with Guile 3.0.

lxd has been upgraded to v5.21.x, an LTS release. The LTS release is now the only supported LXD release. Users are encouraged to migrate to Incus for better support on NixOS.

matrix-synapse homeserver module now supports configuring UNIX domain socket listeners through the path option. The default replication worker on the main instance has been migrated away from TCP sockets to UNIX domain sockets.

mockgen has changed to the go.uber.org/mock fork because the original repository is no longer maintained.

mpich now requires withPm to be a list, e.g. "hydra:gforker" becomes [ "hydra" "gforker" ].

nextcloud-setup.service no longer changes the group of each file and directory inside /var/lib/nextcloud/{config,data,store-apps} if one of these directories has the wrong owner group. This was part of transitioning the group used for /var/lib/nextcloud, but isn’t necessary anymore.

oils-for-unix, the oil shell’s C++ version is now available. The Python version is still available as oil.

pkgsExtraHardening, a new top-level package set, was added. This is a set of packages built with stricter hardening flags - those that have not yet received enough testing to be applied universally, those that are more likely to cause build failures or those that have drawbacks to their use (e.g. performance or required hardware features).

portunus has been updated to major version 2. This version of Portunus supports strong password hashes, but the legacy hash SHA-256 is also still supported to ensure a smooth migration of existing user accounts. After upgrading, follow the instructions on the upstream release notes to upgrade all user accounts to strong password hashes. Support for weak password hashes will be removed in NixOS 24.11.

programs.fish.package now allows you to override the package used in the fish module.

qt6.qtmultimedia has changed its default backend to QT_MEDIA_BACKEND=ffmpeg (previously gstreamer on Linux or darwin on macOS). The previous native backends remain available but are now minimally maintained. Refer to upstream documentation for further details about each platform.

services.btrbk now automatically selects and provides required compression program depending on the configured stream_compress option.

services.github-runner module has been removed. To configure a single GitHub Actions Runner refer to services.github-runners.*. Note that this will trigger a new runner registration.

services.networkmanager.extraConfig was renamed to services.networkmanager.settings and changed to use the ini type instead of using a multiline string.

services.nextcloud.config.dbport option of the Nextcloud module was removed to match upstream. The port can be specified in services.nextcloud.config.dbhost.

services.kavita now uses the free-form option services.kavita.settings for the application settings file. The options services.kavita.ipAdresses and services.kavita.port now exist at services.kavita.settings.IpAddresses and services.kavita.settings.IpAddresses. The file at services.kavita.tokenKeyFile now needs to contain a secret with 512+ bits instead of 128+ bits.

services.netbird now allows running multiple tunnels in parallel through services.netbird.tunnels.

services.nginx.virtualHosts using forceSSL or globalRedirect can now have redirect codes other than 301 through redirectCode.

services.openssh now has an option authorizedKeysInHomedir, controlling whether ~/.ssh/authorizedKeys is added to authorizedKeysFiles.

services.paperless module no longer uses the previously downloaded NLTK data stored in /var/cache/paperless/nltk. This directory can be removed.

services.postgresql.extraPlugins’ type has expanded. Previously it was a list of packages, now it can also be a function that returns such a list. For example a config line like services.postgresql.extraPlugins = with pkgs.postgresql_11.pkgs; [ postgis ]; is recommended to be changed to services.postgresql.extraPlugins = ps: with ps; [ postgis ];;

services.slskd has been refactored to include more configuration options in the free-form services.slskd.settings option, and some defaults (including listen ports) have been changed to match the upstream defaults. Additionally, disk logging is now disabled by default, and the log rotation timer has been removed. The nginx virtualhost option is now of the vhost-options type.

services.soju now has a wrapper for the sojuctl command, pointed at the service config file. It also has the new option adminSocket.enable, which creates a unix admin socket at /run/soju/admin.

services.stalwart-mail uses the legacy version 0.6.X as default because newer stalwart-mail versions require a manual upgrade process. Change services.stalwart-mail.package to pkgs.stalwart-mail if you wish to switch to the new version.

services.teeworlds module now has a wealth of configuration options, including a new package option.

services.xserver.desktopManager.budgie installs gnome.gnome-terminal by default (instead of mate.mate-terminal).

services.zfs.zed.enableMail now uses the global sendmail wrapper defined by an email module (such as msmtp or Postfix). It no longer requires using a special ZFS build with email support.

sonarr version was bumped to from 3.0.10 to 4.0.3. Consequently existing config database files will be upgraded automatically, but note that some old apparently-working configs might actually be corrupt and fail to upgrade cleanly.

stdenv: The --replace flag in substitute, substituteInPlace, substituteAll, substituteAllStream, and substituteStream is now deprecated if favor of the new --replace-fail, --replace-warn and --replace-quiet. The deprecated --replace equates to --replace-warn.

systemd: when merging unit options (of type unitOption), if at least one definition is a list, all those which aren’t are now lifted into a list, making it possible to accumulate definitions without resorting to mkForce, hence to retain the definitions not anticipating that need.

systemd units can now specify the Upholds= and UpheldBy= unit dependencies via the aptly named upholds and upheldBy options. These options get systemd to enforce that the dependencies remain continuously running for as long as the dependent unit is in a running state.

A stdenv’s default set of hardening flags can now be set via its bintools-wrapper’s defaultHardeningFlags argument. A convenient stdenv adapter, withDefaultHardeningFlags, can be used to override an existing stdenv’s defaultHardeningFlags.

Programs written in Nim are built with libraries selected by lockfiles. The nimPackages and nim2Packages sets have been removed. See https://nixos.org/manual/nixpkgs/unstable#nim for more information.

The EC2 image module now enables the Amazon SSM Agent by default.

A new abstraction to create both read-only as well as writable overlay file systems was added. Available via fileSystems.overlay. See also the NixOS docs.

A new hardening flag, zerocallusedregs was made available, corresponding to the gcc/clang option -fzero-call-used-regs=used-gpr.

A new hardening flag, trivialautovarinit was made available, corresponding to the gcc/clang option -ftrivial-auto-var-init=pattern.

dnsdist has new options to enable and configure a DNSCrypt endpoint (see services.dnsdist.dnscrypt.enable, etc.). The module can generate the DNSCrypt provider key pair and certificates, and also rotates them automatically with no downtime.

The kernel Yama LSM is now enabled by default, which prevents ptracing non-child processes. This means you will not be able to attach gdb to an existing process, but will need to start that process from gdb (so it is a child). Or you can set boot.kernel.sysctl."kernel.yama.ptrace_scope" to 0.

Lisp modules: previously deprecated interface based on common-lisp.sh has now been removed.

The systemd-confinement module extension is now compatible with DynamicUser=true and thus ProtectSystem=strict too.

The default Nix version was updated from 2.11 to 2.13. In particular, this includes a small language alteration in the way floats are represented in builtins.toJSON. See the release notes for 2.12 and 2.13 for more information.

The default Linux Kernel was updated from version 5.15 to 6.1, see Kernelnewbies for what has changed. All Kernels currently shown on kernel.org are available.

systemd has been updated from v252 to v253, see the release notes for more information on the changes.

glibc has been updated from version 2.35 to 2.37, see the release notes for what was changed.

libxcrypt, the library providing the crypt(3) password hashing function, is now built without support for algorithms not flagged strong. This affects the availability of password hashing algorithms used for system login (login(1), passwd(1)), but also Apache2 Basic-Auth, Samba, OpenLDAP, Dovecot, and many other packages.

NixOS now defaults to using nsncd, a non-caching reimplementation of nscd in Rust, as its NSS lookup dispatcher. This replaces the buggy and deprecated nscd implementation provided through glibc. When you find problems, you can switch back by disabling it:

{
  services.nscd.enableNsncd = false;
}

The internal option boot.bootspec.enable is now enabled by default because RFC 0125 was merged. This means you will have a bootspec document called boot.json generated for each system and specialisation in the top-level. This is useful to enable advanced boot use cases in NixOS, such as Secure Boot.

Two changes to nixos-rebuild are important to highlight as well.

Python implements PEP 668, providing better feedback to users that try to run pip install for system-wide or user home installations.

Cinnamon has been updated to version 5.6, see the pull request for what was changed.

GNOME has been updated to version 44, see the the release notes for details.

KDE Plasma has been updated to version 5.27, see the release notes for what was changed.

openra was updated to 20230225. Due to large scope of the update, currently only openraPackages.engines.release and openraPackages.engines.latest packages are available. If you want to use the old engine versions or mods, they were moved to the openraPackages_2019 namespace.

Akkoma, an ActivityPub microblogging server. Available as services.akkoma.

alertmanager-irc-relay, a Prometheus Alertmanager IRC Relay. Available as services.prometheus.alertmanagerIrcRelay.

alice-lg, a looking-glass for BGP sessions. Available as services.alice-lg.

atuin, a sync server for shell history. Available as services.atuin.

authelia, an open-source authentication and authorization server. Available as services.authelia.

birdwatcher, a small HTTP server meant to provide an API defined by Barry O’Donovan’s birds-eye to the BIRD internet routing daemon. Available as services.birdwatcher.

blesh, a line editor written in pure bash. Available as programs.bash.blesh.

Budgie Desktop, a familiar, modern desktop environment. Available as services.xserver.desktopManager.budgie.

clash-verge, a Clash GUI based on tauri. Available as programs.clash-verge.

Cloudlog, a web-based Amateur Radio logging application. Available as services.cloudlog.

consul-template, a template renderer, notifier, and supervisor for HashiCorp Consul and Vault data. Available as services.consul-template.

cups-pdf-to-pdf, a PDF-generating CUPS backend based on cups-pdf. Available as services.printing.cups-pdf.

Deepin Desktop Environment, an elegant, easy to use and reliable desktop environment. Available as services.xserver.desktopManager.deepin.

esphome, a dashboard to configure ESP8266/ESP32 devices for use with Home Automation systems. Available as services.esphome.

frigate, an open source NVR built around real-time AI object detection. Available as services.frigate.

fzf, a command line fuzzyfinder. Available as programs.fzf.

gemstash, a RubyGems.org cache and private gem server. Available as services.gemstash.

gitea-actions-runner, a CI runner for Gitea/Forgejo Actions. Available as services.gitea-actions-runner.

evdevremapkeys, a daemon to remap key events. Available as services.evdevremapkeys.

gmediarender, a simple, headless UPnP/DLNA renderer. Available as services.gmediarender.

go2rtc, a camera streaming application with support for RTSP, WebRTC, HomeKit, FFMPEG, RTMP and other protocols. Available as services.go2rtc.

goeland, an alternative to rss2email written in Golang with many filters. Available as services.goeland.

gonic, a Subsonic music streaming server. Available as services.gonic.

hardware.ipu6, drivers for IPU6 based webcams on Intel Tiger Lake and Alder Lake.

harmonia, a Nix binary cache implemented in Rust using libnixstore. Available as services.harmonia.

hyprland, a dynamic tiling Wayland compositor that doesn’t sacrifice on its looks. Available as programs.hyprland.

imaginary, a microservice for high-level image processing that Nextcloud can use to generate previews. Available as services.imaginary.

ivpn, a secure, private VPN with fast WireGuard connections. Available as services.ivpn.

vmalert, an alerting engine for VictoriaMetrics. Available as services.vmalert.

jellyseerr, a web-based requests manager for Jellyfin, forked from Overseerr. Available as services.jellyseerr.

kavita, a self-hosted digital library. Available as services.kavita.

keyd, a key remapping daemon for Linux. Available as services.keyd.

lldap, a lightweight authentication server that provides an opinionated, simplified LDAP interface for authentication. Available as services.lldap.

minipro, an open source program for controlling the MiniPRO TL866xx series of chip programmers. Available as programs.minipro.

mmsd, a lower level daemon that transmits and receives MMSes. Available as services.mmsd.

monica, an open source personal CRM. Available as services.monica.

networkd-dispatcher, a dispatcher service for systemd-networkd connection status changes. Available as services.networkd-dispatcher.

nimdow, a window manager written in Nim, inspired by dwm. Available as services.xserver.windowManager.nimdow.enable.

opensearch, a search server alternative to Elasticsearch. Available as services.opensearch.

openvscode-server, run VS Code on a remote machine with access through a modern web browser from any device, anywhere. Available as services.openvscode-server.

peroxide, a fork of the official ProtonMail bridge that aims to be similar to Hydroxide. Available as services.peroxide.

photoprism, a AI-powered photos app for the decentralized web. Available as services.photoprism.

Pixelfed, an Instagram-like ActivityPub server. Available as services.pixelfed.

PufferPanel, a game server management panel designed to be easy to use. Available as services.pufferpanel.

QDMR, a GUI application and command line tool for programming DMR radios programs.qdmr.

readarr, book manager and automation (Sonarr for ebooks). Available as services.readarr.

ReGreet, a clean and customizable greeter for greetd. Available as programs.regreet.

rshim, the user-space rshim driver for the BlueField SoC. Available as services.rshim.

SFTPGo, a fully featured and highly configurable SFTP server with optional HTTP/S, FTP/S and WebDAV support. Available as services.sftpgo.

sharing, a command-line tool to share directories and files from the CLI to iOS and Android devices without the need of an extra client app. Available as programs.sharing.

sniffnet, an application to monitor your network traffic. Available as programs.sniffnet.

stargazer, a fast and easy to use Gemini server. Available as services.stargazer.

stevenblack-blocklist, a unified hosts file with base extensions for blocking unwanted websites. Available as networking.stevenblack.

systemd-repart, grow and add partitions to a partition table. Available as systemd.repart and boot.initrd.systemd.repart

trippy, a network diagnostic tool. Available as programs.trippy.

tts, a battle-tested deep learning toolkit for Text-to-Speech. Multiple servers may be configured below services.tts.servers.

ulogd, a userspace logging daemon for netfilter/iptables related logging. Available as services.ulogd.

v2rayA, a Linux web GUI client of Project V which supports V2Ray, Xray, SS, SSR, Trojan and Pingtunnel. Available as services.v2raya.

v4l2-relayd, a streaming relay for v4l2loopback using gstreamer. Available as services.v4l2-relayd.

vault-agent, a template renderer and API auth proxy for HashiCorp Vault, similar to consul-template. Available as services.vault-agent.

webhook, a lightweight webhook server. Available as services.webhook.

wgautomesh, a simple utility to help connect wireguard nodes together in a full mesh topology. Available as services.wgautomesh.

woodpecker, a simple CI engine with great extensibility. Available as services.woodpecker-server and services.woodpecker-agents.

wstunnel, a proxy tunnelling arbitrary TCP or UDP traffic through a WebSocket connection. Available as services.wstunnel.

services.asusd configuration now uses strings instead of structured configuration, as upstream switched to the RON configuration format. Support for structured configuration may return when RON generation is implemented in nixpkgs.

borgbackup module now has an option for inhibiting system sleep while backups are running, defaulting to off (not inhibiting sleep), available as services.borgbackup.jobs.<name>.inhibitsSleep.

The openssh client now comes with the ~C escape sequence disabled by default. It can be re-enabled by setting EnableEscapeCommandline yes

The programs.ssh client module does not read /etc/ssh/ssh_known_hosts2 anymore, since this location is deprecated since 2001.

The services.openssh server module does not read ~/.ssh/authorized_keys2 anymore, since this location is deprecated since 2001.

MAC-then-encrypt algorithms were removed from the default selection of services.openssh.settings.Macs. If you still require these MACs, for example when you are relying on libssh2 (e.g. VLC) or the SSH library shipped on the iPhone, you can re-add them like this:

{
  services.openssh.settings.Macs = [
    "hmac-sha2-512"
    "hmac-sha2-256"
    "umac-128@openssh.com"
  ];
}

podman now uses the netavark network stack. Users will need to delete all of their local containers, images, volumes, etc, by running podman system reset --force once before upgrading their systems.

git-bug has been updated to at least version 0.8.0, which includes backwards incompatible changes. The git-bug-migration package can be used to upgrade existing repositories.

graylog has been updated to version 5, which can not be updated directly from the previously packaged version 3.3. If you had installed the previously packaged version 3.3, please follow the upgrade path from 3.3 to 4.0 to 4.3 to 5.0.

buildFHSUserEnv is now called buildFHSEnv and uses FlatPak’s Bubblewrap sandboxing tool rather than Nixpkgs’ own chrootenv. The old chrootenv-based implementation is still available via buildFHSEnvChroot but is considered deprecated and will be removed when the remaining uses inside Nixpkgs have been migrated. If your FHSEnv-wrapped application misbehaves when using the new bubblewrap implementation, please create an issue in Nixpkgs.

nushell has been updated to at least version 0.77.0, which includes potential breaking changes in aliases. The old aliases are now available as old-alias but it is recommended you migrate to the new format. See Reworked aliases.

gajim has been updated to version 1.7.3 which has disabled legacy ciphers. See changelog for version 1.7.0.

keepassx and keepassx2 have been removed, due to upstream stopping development. Consider KeePassXC as a maintained alternative.

The services.kubo.settings option is now no longer stateful. If you changed any of the options in services.kubo.settings in the past and then removed them from your NixOS configuration again, those changes are still in your Kubo configuration file but will now be reset to the default. If you’re unsure, you may want to make a backup of your configuration file (probably /var/lib/ipfs/config) and compare after the update.

The Kubo HTTP API will no longer listen on localhost and will instead only listen on a Unix domain socket by default. Read the services.kubo.settings.Addresses.API option description for more information.

The EC2 image module no longer fetches instance metadata in stage-1. This results in a significantly smaller initramfs, since network drivers no longer need to be included, and faster boots, since metadata fetching can happen in parallel with startup of other services. This breaks services which rely on metadata being present by the time stage-2 is entered. Anything which reads EC2 metadata from /etc/ec2-metadata should now have an after dependency on fetch-ec2-metadata.service

The mailman service now defaults to using a randomly generated REST API password instead of a hard-coded one.

minio removed support for its legacy filesystem backend in RELEASE.2022-10-29T06-21-33Z. This means if your storage was created with the old format, minio will no longer start. Unfortunately, minio doesn’t provide an automatic migration, they only provide instructions how to manually convert the node. To facilitate this migration, we keep around the last version that still supports the old filesystem backend as minio_legacy_fs. Use it via services.minio.package = minio_legacy_fs; to export your data before switching to the new version. See the corresponding issue for more details.

services.sourcehut.dispatch and the corresponding package (sourcehut.dispatchsrht) have been removed due to upstream deprecation.

The attributes used by services.snapper.configs.<name> have changed. Migrate from this:

{
  services.snapper.configs.example = {
    subvolume = "/example";
    extraConfig = ''
      ALLOW_USERS="alice"
    '';
  };
}

to this:

{
  services.snapper.configs.example = {
    SUBVOLUME = "/example";
    ALLOW_USERS = [ "alice" ];
  };
}

The default module options for services.snapserver.openFirewall, services.tmate-ssh-server.openFirewall and services.unifi-video.openFirewall have been changed from true to false. You will need to explicitly set this option to true, or configure your firewall.

The option i18n.inputMethod.fcitx5.enableRimeData has been removed. Default RIME data is now included in fcitx5-rime by default, and can be customized using

fcitx5-rime.override {
  rimeDataPkgs = [
    pkgs.rime-data
    # ...
  ];
}

The udev hwdb.bin file is now built with systemd-hwdb rather than the deprecated “udevadm hwdb”. This may impact mappings where the same key is defined in multiple matching entries. The updated behavior will select the latest definition in case of conflict. In general, this should be a positive change, as the hwdb source files are designed with this ordering in mind. As an example, the mapping of the HP Dev One keyboard scan code for “mute mic” is corrected by this update. This change may impact users who have worked-around previously incorrect mappings.

Kime has been updated from 2.5.6 to 3.0.2 and the i18n.inputMethod.kime.config option has been removed. Users should use daemonModules, iconColor, and extraConfig options under i18n.inputMethod.kime instead.

tut has been updated from 1.0.34 to 2.0.0, and now uses the TOML format for the configuration file instead of INI. Additional information can be found here.

i3status-rust has been updated from 0.22.0 to 0.30.5, and this brings many changes to its configuration format. Additional information can be found here.

The wordpress derivation no longer contains any built-in plugins or themes. If you need them, you have to add them back to prevent your site from breaking. You can find them in wordpressPackages.{plugins,themes}.

llvmPackages_rocm.llvm will not contain clang or compiler-rt. llvmPackages_rocm.clang will not contain llvm. llvmPackages_rocm.clangNoCompilerRt has been removed in favor of using llvmPackages_rocm.clang-unwrapped.

services.xserver.desktopManager.plasma5.excludePackages has been moved to environment.plasma5.excludePackages, for consistency with other Desktop Environments.

teleport has been updated from major version 10 to major version 12. Please see upstream upgrade instructions and release notes for versions 11 and 12. Note that Teleport does not officially support upgrades across more than one major version at a time. If you’re running Teleport server components, it is recommended to first upgrade to an intermediate 11.x version by setting services.teleport.package = pkgs.teleport_11. Afterwards, this option can be removed to upgrade to the default version (12).

The EC2 image module previously detected and automatically mounted ext3-formatted instance store devices and partitions in stage-1 (initramfs), storing /tmp on the first discovered device. This behaviour, which only catered to very specific use cases and could not be disabled, has been removed. Users relying on this should provide their own implementation, and probably use ext4 and perform the mount in stage-2.

The EC2 image module previously detected and activated swap-formatted instance store devices and partitions in stage-1 (initramfs). This behaviour has been removed. Users relying on this should provide their own implementation.

gitlab has been upgraded from major version 15 to major version 16 and requires at least PostgreSQL 13.6. Check the upgrade guide in the NixOS manual on how to upgrade your PostgreSQL installation.

gitlab 16 deprecates the use of external container registries, in our case pkgs.docker-distribution. Module users who have services.gitlab.registry.enable set to true are advised to back up their state and switch to gitlab’s fork by setting services.gitlab.registry.package to pkgs.gitlab-container-registry.

fail2ban has been updated to 1.0.2, which has a few breaking changes compared to 0.11.2 (changelog for 1.0.1, changelog for 1.0.2)

albert has been updated from 0.17.6 to 0.20.13, and 0.18.0 changed the config format and many plugins (changelog for 0.18.0)

dokuwiki has been updated from 2023-07-31a (Igor) to 2023-04-04 (Jack Jackrum), which has completely removed the options to embed HTML and PHP for security reasons. The htmlok plugin can be used to regain this functionality.

The old unsupported version 6.x of the ELK-stack and Elastic beats have been removed. Use OpenSearch instead.

The cosmoc package has been removed. The upstream scripts in cosmocc should be used instead.

Qt 5.12 and 5.14 have been removed, as the corresponding branches have been EOL upstream for a long time. This affected under 10 packages in nixpkgs, largely unmaintained upstream as well, however, out-of-tree package expressions may need to be updated manually.

The services.wordpress.sites.<name>.plugins and services.wordpress.sites.<name>.themes options have been converted from sets to attribute sets to allow for consumers to specify explicit install paths via attribute name.

protonmail-bridge package has been updated to major version 3.

Nebula now runs as a system user and group created for each nebula network, using the CAP_NET_ADMIN ambient capability on launch rather than starting as root. Ensure that any files each Nebula instance needs to access are owned by the correct user and group, by default nebula-${networkName}.

The i18n.inputMethod.fcitx option has been replaced with i18n.inputMethod.fcitx5 because fcitx 4 pkgs.fcitx has been removed.

In mastodon it is now necessary to specify location of file with PostgreSQL database password. In services.mastodon.database.passwordFile parameter default value /var/lib/mastodon/secrets/db-password has been changed to null.

The nix.readOnlyStore option has been renamed to boot.readOnlyNixStore to clarify that it configures the NixOS boot process, not the Nix daemon.

The latest available version of Nextcloud is v26 (available as pkgs.nextcloud26) which uses PHP 8.2 as interpreter by default. The installation logic is as follows:

.NET 5.0 and .NET 3.1 were removed due to being end-of-life, use a newer, supported .NET version. Visit the Support Policy for more information.

The iputils package, which is installed by default, no longer provides the ninfod, rarpd and rdisc tools. See upstream’s release notes for more details and available replacements.

The ppp plugin rp-pppoe.so has been renamed to pppoe.so in ppp 2.4.9. Starting from ppp 2.5.0, there is no longer an alias for backwards compatibility. Configurations that use this plugin must be updated accordingly from plugin rp-pppoe.so to plugin pppoe.so. See upstream change.

services.xserver.videoDrivers now defaults to the modesetting driver over device-specific ones. The radeon, amdgpu and nouveau drivers are still available, but effectively unmaintained and not recommended for use. Note that this does not affect your regular graphics drivers; this only concerns the DDX component of the driver, which most people are not relying on.

services.xserver.libinput.enable is now set by default, enabling the more actively maintained and consistently behaved input device driver.

To enable the HTTP3 (QUIC) protocol for a nginx virtual host, set the quic attribute on it to true, e.g. services.nginx.virtualHosts.<name>.quic = true;.

In services.fail2ban, bantime-increment.<name> options now default to null (except bantime-increment.enable) and are used to set the corresponding option in jail.local only if not null. Also, enforce that bantime-increment.formula and bantime-increment.multipliers are not both specified.

The default asterisk package was changed to v20 from v19. Asterisk versions 16 and 19 have been dropped due to being EOL. You may need to update /var/lib/asterisk to match the template files in ${asterisk-20}/var/lib/asterisk.

conntrack helper autodetection has been removed from kernels 6.0 and up upstream, and an assertion was added to ensure things don’t silently stop working. Migrate your configuration to assign helpers explicitly or use an older LTS kernel branch as a temporary workaround.

The services.pipewire.config options have been removed, as they have basically never worked correctly. All behavior defined by the default configuration can be overridden with drop-in files as necessary - see below for details.

The catch-all hardware.video.hidpi.enable option was removed. Users on high density displays may want to:

services.pipewire.media-session and the pipewire-media-session package have been removed, as they are no longer supported upstream. Users are encouraged to use services.pipewire.wireplumber instead.

The baget package and module was removed due to being unmaintained.

The qlandkartegt and garmindev packages were removed due to being unmaintained and insecure.

The go-ethereum package has been updated to v1.11.5 and the puppeth command is no longer available as of v1.11.0.

The pnpm package has be updated to from version 7.29.1 to version 8.1.1 and Node.js 14 support has been discontinued (though, there are workarounds if Node.js 14 is still required)

The zplug package changes its output path from $out to $out/share/zplug. Users should update their dependency on ${pkgs.zplug}/init.zsh to ${pkgs.zplug}/share/zplug/init.zsh.

The pict-rs package was updated from an 0.3 alpha release to 0.3 stable, and related environment variables now require two underscores instead of one.

The shattered-pixel-dungeon game was updated from 1.1.2 to 2.0.2.

espanso has been updated to major version 2. Therefore, migration steps may need to be performed. See the official migration instructions for how to perform these migrations. Further, espanso-wayland can now be used for Wayland support.

Only k3s version 1.26 is included. Users of the k3s_1_24 or k3s_1_25 packages should upgrade to use the 1.26 version of the package.

The nerdfonts package has been updated to major version 3, which includes potential breaking changes.

To follow RFC 0042 a few options of openssh have been moved from extraConfig to the new freeform option settings and renamed, e.g.:

vim_configurable has been renamed to vim-full to avoid confusion: vim-full’s build-time features are configurable, but both vim and vim-full are customizable (in the sense of user configuration, like vimrc).

Pantheon now defaults to Mutter 43 and GNOME settings daemon 43, all Pantheon packages are now tracking elementary OS 7 updates.

The module for the application firewall opensnitch got the ability to configure rules. Available as services.opensnitch.rules

The module usbmuxd now has the ability to change the package used by the daemon. In case you’re experiencing issues with usbmuxd you can try an alternative program like usbmuxd2. Available as services.usbmuxd.package

netbox was updated to 3.5. NixOS’ services.netbox.package still defaults to 3.3 if stateVersion is earlier than 23.05. Please review upstream’s breaking changes for 3.4.0 and for 3.5.0, and upgrade NetBox by changing services.netbox.package. Database migrations will be run automatically.

services.netbox now support RFC42-style options, through services.netbox.settings.

services.mastodon gained a tootctl wrapped named mastodon-tootctl similar to nextcloud-occ which can be executed from any user and switches to the configured mastodon user with sudo and sources the environment variables.

services.borgmatic now allows for multiple configurations, placed in /etc/borgmatic.d/, you can define them with services.borgmatic.configurations.

service.openafsServer features a new backup server pkgs.fabs as a replacement for openafs’s own buserver. See FABS to check if this is an viable replacement. It stores backups as volume dump files and thus better integrates into contemporary backup solutions.

services.maddy got several updates:

The dnsmasq service now takes configuration via the services.dnsmasq.settings attribute set. The option services.dnsmasq.extraConfig will be deprecated when NixOS 22.11 reaches end of life.

The dokuwiki service is now configured via services.dokuwiki.sites.<name>.settings attribute set; extraConfig has been removed. The {aclUse,superUser,disableActions} attributes have been renamed accordingly. pluginsConfig now only accepts an attribute set of booleans. Passing plain PHP is no longer possible. Same applies to acl which now also only accepts structured settings.

The zsh package changes the way to set environment variables on NixOS systems where programs.zsh.enable equals false. It now sources /etc/set-environment when reading the system-level zshenv file. Before, it sourced /etc/profile when reading the system-level zprofile file.

The wordpress service now takes configuration via the services.wordpress.sites.<name>.settings attribute set, extraConfig is still available to append additional text to wp-config.php.

To reduce closure size in nixos/modules/profiles/minimal.nix profile disabled installation documentations and manuals. Also disabled logrotate and udisks2 services.

To reduce closure size in nixos/modules/installer/netboot/netboot-minimal.nix profile disabled load linux firmwares, pre-installing the complete stdenv and networking.wireless service.

The minimal ISO image now uses the nixos/modules/profiles/minimal.nix profile.

NixOS installer ISOs can now be built for powerpc64le-linux; see nixos/modules/installer/sd-card/sd-image-powerpc64le.nix and PR 192672. Hydra does not support this platform, so you must build the binaries yourself.

The ghcWithPackages and ghcWithHoogle wrappers will now also symlink GHC’s and all included libraries’ documentation to $out/share/doc for convenience. If undesired, the old behavior can be restored by overriding the builders with { installDocumentation = false; }.

The nftables module now validates its ruleset at build time. The new networking.nftables.checkRuleset option allows disabling this check, which may fail when rules have very specific requirements, that the sandbox environment, by default, will not cover. The networking.nftables.preCheckRuleset option can be used to prepare the environment before the checks are run.

The services.mastodon module now supports connection to a remote PostgreSQL database.

services.nextcloud.database.createLocally now uses socket authentication and is no longer compatible with password authentication.

services.nextcloud.config.objectstore.s3.sseCKeyFile is a new option to enable server-side encryption with customer provided keys (SSE-C) for your S3 in Nextcloud.

NixOS swap partitions with random encryption can now control the sector size, cipher, and key size used to set up the plain encryption device over the underlying block device rather than allowing them to be determined by cryptsetup(8). One can use these features like so:

{
  swapDevices = [ {
    device = "/dev/disk/by-partlabel/swapspace";
    randomEncryption = {
      enable = true;
      cipher = "aes-xts-plain64";
      keySize = 512;
      sectorSize = 4096;
    };
  } ];
}

New option security.pam.zfs to enable unlocking and mounting of encrypted ZFS home dataset at login.

services.peertube now requires you to specify the secret file secrets.secretsFile. It can be generated by running openssl rand -hex 32. Before upgrading, check the release notes for PeerTube v5.0.0.And backup your data.

services.chronyd is now started with additional systemd sandbox/hardening options for better security.

PostgreSQL has added opt-in support for JIT compilation. It can be enabled like this:

{
  services.postgresql.enableJIT = true;
}

services.netdata offers a services.netdata.deadlineBeforeStopSec option which will control the deadline (in seconds) after which systemd will consider your netdata instance as dead if it didn’t start in the elapsed time. It is helpful when your netdata instance takes longer to start because of a large amount of state or upgrades.

services.dhcpcd service stopped soliciting or accepting IPv6 Router Advertisements on interfaces that use static IPv6 addresses. If your network provides both IPv6 unique local addresses (ULA) and globally unique addresses (GUA) through autoconfiguration with SLAAC, you must add the parameter networking.dhcpcd.IPv6rs = true;.

The module services.headscale was refactored to be compliant with RFC 0042. To be precise, this means that the following things have changed:

services.kubo now unmounts ipfsMountDir and ipnsMountDir even if it is killed unexpectedly when autoMount is enabled.

services.grafana listens only on localhost by default again. This was changed to the upstream default of 0.0.0.0 by accident in the freeform setting conversion.

Grafana Tempo has been updated to version 2.0. See the upstream upgrade guide for migration instructions.

A new virtualisation.rosetta module was added to allow running x86_64 binaries through Rosetta inside virtualised NixOS guests on Apple Silicon. This feature works by default with the UTM virtualisation package.

The new option users.motdFile allows configuring a Message Of The Day that can be updated dynamically.

The root package is now built with the "-Dgnuinstall=ON" CMake flag, making the output conform the bin lib share layout. In this layout, tutorials is under share/doc/ROOT/; cmake, font, icons, js and macro under share/root; Makefile.comp and Makefile.config under etc/root.

There are various new options in the services.nginx module:

The nginx module also received an update to services.nginx.recommendedGzipSettings:

Garage version is based on system.stateVersion, existing installations will keep using version 0.7. New installations will use version 0.8. In order to upgrade a Garage cluster, please follow upstream instructions and configure services.garage.package.

Nebula now supports the services.nebula.networks.<name>.isRelay and services.nebula.networks.<name>.relays configuration options for setting up or allowing traffic relaying. See the announcement for more details about relays.

Resilio sync secret keys can now be provided using a secrets file at runtime, preventing these secrets from ending up in the Nix store.

The firewall and nat modules can now optionally rely on an nftables based implementation. Enable networking.nftables to use it.

The services.fwupd module now allows arbitrary daemon settings to be configured in a structured manner (services.fwupd.daemonSettings).

services.xserver.desktopManager.plasma5.phononBackend now defaults to vlc according to upstrean recommendation

The zramSwap is now implemented with zram-generator, and the option zramSwap.numDevices for using ZRAM devices as general purpose ephemeral block devices has been removed.

As Singularity has renamed to Apptainer to distinguish from an un-renamed fork by Sylabs Inc., there are now two packages of Singularity/Apptainer:

singularity-tools.buildImage got a new input argument singularity to specify which package to use.

The new option programs.singularity.enableFakeroot, if set to true, provides --fakeroot support for apptainer and singularity.

The new option services.tailscale.useRoutingFeatures controls various settings for using Tailscale features like exit nodes and subnet routers. If you wish to use your machine as an exit node, you can set this setting to server, otherwise if you wish to use an exit node you can set this setting to client. The strict RPF warning has been removed as the RPF will be loosened automatically based on the value of this setting.

openjdk from version 11 and above is not build with openjfx (i.e.: JavaFX) support by default anymore. You can re-enable it by overriding, e.g.: openjdk11.override { enableJavaFX = true; };.

Xastir can now access AX.25 interfaces via the libax25 package.

nixos-version now accepts --configuration-revision to display more information about the current generation revision

The option services.nomad.extraSettingsPlugins has been fixed to allow more than one plugin in the path.

The option services.prometheus.exporters.pihole.interval does not exist anymore and has been removed.

The option services.gpsd.device has been replaced with services.gpsd.devices, which supports multiple devices.

k3s can now be configured with an EnvironmentFile for its systemd service, allowing secrets to be provided without ending up in the Nix Store.

The gitea module options have been moved into a freeform attribute set below services.gitea.settings.

boot.initrd.luks.device.<name> has a new tryEmptyPassphrase option, this is useful for OEMs who need to install an encrypted disk with a future settable passphrase

The bind module now allows the per-zone allow-query setting to be configured (previously it was hard-coded to any; it still defaults to any to retain compatibility).

The option services.jitsi-videobridge.apis has been renamed to colibriRestApi and turned into a boolean. Setting it to true will enable the private rest API, useful for monitoring using services.prometheus.exporters.jitsi.enable. Learn more about the API: “The COLIBRI control interface (/colibri/)”.

Booting from a volume managed by the Stratis storage management daemon is now supported. Use fileSystems.<name>.stratis.poolUuid to configure the pool containing the fs.

buildDunePackage now defaults to strictDeps = true which means that any library should go into buildInputs or checkInputs. Any executable that is run on the building machine should go into nativeBuildInputs or nativeCheckInputs respectively. Example of executables are ocaml, findlib and menhir. PPXs are libraries which are built by dune and should therefore not go into nativeBuildInputs.

buildFHSUserEnv is now called buildFHSEnv and uses FlatPak’s Bubblewrap sandboxing tool rather than Nixpkgs’ own chrootenv. The old chrootenv-based implementation is still available via buildFHSEnvChroot but is considered deprecated and will be removed when the remaining uses inside Nixpkgs have been migrated. If your FHSEnv-wrapped application misbehaves when using the new bubblewrap implementation, please create an issue in Nixpkgs.

Top-level buildPlatform, hostPlatform, targetPlatform have been deprecated, use stdenv.X instead.

carnix and cratesIO has been removed due to being unmaintained, use alternatives such as naersk and crate2nix instead.

checkInputs have been renamed to nativeCheckInputs, because they behave the same as nativeBuildInputs when doCheck is set. checkInputs now denote a new type of dependencies, added to buildInputs when doCheck is set. As a rule of thumb, nativeCheckInputs are tools on $PATH used during the tests, and checkInputs are libraries which are linked to executables built as part of the tests. Similarly, installCheckInputs are renamed to nativeInstallCheckInputs, corresponding to nativeBuildInputs, and installCheckInputs are a new type of dependencies added to buildInputs when doInstallCheck is set. (Note that this change will not cause breakage to derivations with strictDeps unset, which are most packages except python, rust, ocaml and go packages).

DocBook option documentation, which has been deprecated since 22.11, will now cause a warning when documentation is built. Out-of-tree modules should migrate to using CommonMark documentation as outlined in the section called “Option Declarations” to silence this warning.

DocBook option documentation support will be removed in the next release and CommonMark will become the default. DocBook option documentation that has not been migrated until then will no longer render properly or cause errors.

lib.systems.examples.ghcjs and consequently pkgsCross.ghcjs now use the target triplet javascript-unknown-ghcjs instead of js-unknown-ghcjs. This has been done to match an upstream decision to follow Cabal’s platform naming more closely. Nixpkgs will also reject js as an architecture name.

Lisp gained a manual section, documenting a new and backwards incompatible interface. The previous interface will be removed in a future release.

Calling makeSetupHook without passing a name argument is deprecated.

nixos/lib/make-disk-image.nix handles contents arguments that are directories better, fixing a bug where it used to put them in a subdirectory of the intended target.

nixos/lib/make-disk-image.nix can now mutate EFI variables, run user-provided EFI firmware or variable templates. This is now extensively documented in the NixOS manual.

Nixpkgs now uses IEEE-standard floating point arithmetic on powerpc64le-linux.

Deprecated xlibsWrapper transitional package has been removed in favour of direct use of its constituents: xorg.libX11, freetype and others.

Software that uses the crypt password hashing API is now using the implementation provided by libxcrypt instead of glibc’s, which enables support for more secure algorithms.

The NixOS documentation is now generated from markdown. While docbook is still part of the documentation build process, it’s a big step towards the full migration.

aarch64-linux is now included in the nixos-22.11 and nixos-22.11-small channels. This means that when those channel update, both x86_64-linux and aarch64-linux will be available in the binary cache.

aarch64-linux ISOs are now available on the downloads page.

nsncd is now available as a replacement of nscd.

nscd is responsible for resolving hostnames, users and more in NixOS and has been a long standing source of bugs, such as sporadic network freezes.

More context in this issue.

Help us test the new implementation by setting services.nscd.enableNsncd to true.

We plan to use nsncd by default in NixOS 23.05.

Linode cloud images are now supported by importing ${modulesPath}/virtualisation/linode-image.nix and accessing system.build.linodeImage on the output.

hardware.nvidia has a new option, hardware.nvidia.open, that can be used to enable the usage of NVIDIA’s open-source kernel driver. Note that the driver’s support for GeForce and Workstation GPUs is still alpha quality, see the release announcement for more information.

The emacs package now makes use of native compilation which means:

Haskell ghcWithPackages is now up to 15 times faster to evaluate, thanks to changing lib.closePropagation from a quadratic to linear complexity. Please see backward incompatibilities notes below. https://github.com/NixOS/nixpkgs/pull/194391

For cross-compilation targets that can also run on the building machine, we now run tests. This, for example, is the case for the pkgsStatic and pkgsLLVM package sets or i686 packages on x86_64 machines.

To simplify cross-compilation in NixOS, this release introduces the nixpkgs.hostPlatform and nixpkgs.buildPlatform options. These cover and override the nixpkgs.{system,localSystem,crossSystem} options.

The new options convey the same information, but with fewer options, and following the Nixpkgs terminology.

The existing options nixpkgs.{system,localSystem,crossSystem} have not been formally deprecated, to allow for evaluation of the change and to allow for a transition period so that in time the ecosystem can switch without breaking compatibility with any supported NixOS release.

Nix has been upgraded from v2.8.1 to v2.11.0. For more information, please see the release notes for 2.9, 2.10 and 2.11.

OpenSSL now defaults to OpenSSL 3, updated from 1.1.1.

GNOME has been upgraded to version 43. Please see the release notes for details.

KDE Plasma has been upgraded from v5.24 to v5.26. Please see the release notes for v5.25 and v5.26 for more details on the included changes.

Cinnamon has been updated to 5.4, and the Cinnamon module now defaults to Blueman as the Bluetooth manager and slick-greeter as the LightDM greeter, to match upstream.

PHP now defaults to PHP 8.1, updated from 8.0.

Perl has been updated to 5.36, and its core module HTTP::Tiny was patched to verify SSL/TLS certificates by default.

Python now defaults to 3.10, updated from 3.9.

Nixpkgs now requires Nix 2.3 or newer.

The isCompatible predicate checking CPU compatibility is no longer exposed by the platform sets generated using lib.systems.elaborate. In most cases you will want to use the new canExecute predicate instead which also takes the kernel / syscall interface into account. lib.systems.parse.isCompatible still exists, but has changed semantically: Architectures with differing endianness modes are no longer considered compatible.

ngrok has been upgraded from 2.3.40 to 3.0.4. Please see the upgrade guide and changelog. Notably, breaking changes are that the config file format has changed and support for single hyphen arguments was dropped.

i18n.supportedLocales is now only generated with the locales set in i18n.defaultLocale and i18n.extraLocaleSettings.

Deprecated settings logrotate.paths and logrotate.extraConfig have been removed. Please convert any uses to services.logrotate.settings instead.

The isPowerPC predicate, found on platform attrsets (hostPlatform, buildPlatform, targetPlatform, etc) has been removed in order to reduce confusion. The predicate was was defined such that it matches only the 32-bit big-endian members of the POWER/PowerPC family, despite having a name which would imply a broader set of systems. If you were using this predicate, you can replace foo.isPowerPC with (with foo; isPower && is32bit && isBigEndian).

The fetchgit fetcher now uses cone mode by default for sparse checkouts. Non-cone mode can be enabled by passing nonConeMode = true, but note that non-cone mode is deprecated and this option may be removed alongside a future Git update without notice.

The fetchgit fetcher supports sparse checkouts via the sparseCheckout option. This used to accept a multi-line string with directories/patterns to check out, but now requires a list of strings.

openssh was updated to version 9.1, disabling the generation of DSA keys when using ssh-keygen -A as they are insecure. Also, SetEnv directives in ssh_config and sshd_config are now first-match-wins.

bsp-layout no longer uses the command cycle to switch to other window layouts, as it got replaced by the commands previous and next.

The Barco ClickShare driver/client package pkgs.clickshare-csc1 and the option programs.clickshare-csc1.enable have been removed, as it requires qt4, which reached its end-of-life 2015 and will no longer be supported by nixpkgs. According to Barco many of their base unit models can be used with Google Chrome and the Google Cast extension.

services.hbase has been renamed to services.hbase-standalone. For production HBase clusters, use services.hadoop.hbase instead.

The p4 package now only includes the open-source Perforce Helix Core command-line client and APIs. It no longer installs the unfree Helix Core Server binaries p4d, p4broker, and p4p. To install the Helix Core Server binaries, use the p4d package instead.

The OpenSSL extension for the PHP interpreter used by Nextcloud is built against OpenSSL 1.1 if system.stateVersion is below 22.11. This is to make sure that people using server-side encryption don’t lose access to their files.

In any other case, it’s safe to use OpenSSL 3 for PHP’s OpenSSL extension. This can be done by setting services.nextcloud.enableBrokenCiphersForSSE to false.

The coq package and versioned variants starting at coq_8_14 no longer include CoqIDE, which is now available through coqPackages.coqide. It is still possible to get CoqIDE as part of the coq package by overriding the buildIde argument of the derivation.

PHP 7.4 is no longer supported due to upstream not supporting this version for the entire lifecycle of the 22.11 release.

The ipfs package and module were renamed to kubo. The kubo module now uses an RFC42-style settings option instead of extraConfig and the gatewayAddress, apiAddress and swarmAddress options were renamed. Using the old names will print a warning but still work.

pkgs.cosign does not provide the cosigned binary anymore. The sget binary has been moved into its own package.

Emacs now uses the Lucid toolkit by default instead of GTK because of stability and compatibility issues. Users who still wish to remain using GTK can do so by using emacs-gtk.

kanidm has been updated to 1.1.0-alpha.10 and now requires a TLS certificate and key. It will always start https and-–-if enabled-–-an LDAPS server and no HTTP and LDAP server anymore.

riak package removed along with services.riak module, due to lack of maintainer to update the package.

ppd files in pkgs.cups-drv-rastertosag-gdi are now gzipped. If you refer to such a ppd file with its path (e.g. via hardware.printers.ensurePrinters) you will need to append .gz to the path.

xow package removed along with the hardware.xow module, due to the project being deprecated in favor of xone, which is available via the hardware.xone module.

dd-agent package removed along with the services.dd-agent module, due to the project being deprecated in favor of datadog-agent, which is available via the services.datadog-agent module.

teleport has been upgraded to major version 10. Please see upstream upgrade instructions and release notes.

lib.closePropagation now needs that all gathered sets have an outPath attribute.

lemmy module option services.lemmy.settings.database.createLocally moved to services.lemmy.database.createLocally.

virtlyst package and services.virtlyst module removed, due to lack of maintainers.

The nix.checkConfig option now fully disables the config check. The new nix.checkAllErrors option behaves like nix.checkConfig previously did.

generateOptparseApplicativeCompletions and generateOptparseApplicativeCompletion from haskell.lib.compose (and haskell.lib) have been deprecated in favor of generateOptparseApplicativeCompletions (plural!) as provided by the haskell package sets (so haskellPackages.generateOptparseApplicativeCompletions etc.). The latter allows for cross-compilation (by automatically disabling generation of completion in the cross case). For it to work properly you need to make sure that the function comes from the same context as the package you are trying to override, i.e. always use the same package set as your package is coming from or – even better – use self.generateOptparseApplicativeCompletions if you are overriding a haskell package set. The old functions are retained for backwards compatibility, but yield are warning.

The services.graphite.api and services.graphite.beacon NixOS options, and the python3.pkgs.graphite_api, python3.pkgs.graphite_beacon and python3.pkgs.influxgraph packages, have been removed due to lack of upstream maintenance.

The trace binary from perf-linux package has been removed, due to being a duplicate of the perf binary.

The aws package has been removed due to being abandoned by the upstream. It is recommended to use awscli or awscli2 instead.

The CEmu TI-84 Plus CE emulator package has been renamed to cemu-ti. The Cemu Wii U emulator is now packaged as cemu.

systemd-networkd v250 deprecated, renamed, and moved some sections and settings which leads to the following breaking module changes:

arangodb versions 3.3, 3.4, and 3.5 have been removed because they are at EOL upstream. The default is now 3.10.0. Support for aarch64-linux has been removed since the target cannot be built reproducibly. By default arangodb is now built for the haswell architecture. If you wish to build for a different architecture, you may override the targetArchitecture argument with a value from this list supported upstream. Some architecture specific optimizations are also conditionally enabled. You may alter this behavior by overriding the asmOptimizations parameter. You may also add additional architecture support by adding more -DHAS_XYZ flags to cmakeFlags via overrideAttrs.

The meta.mainProgram attribute of packages in wineWowPackages now defaults to "wine64".

The paperless module now defaults PAPERLESS_TIME_ZONE to your configured system timezone.

The top-level termonad-with-packages alias for termonad has been removed.

Linux 4.9 has been removed because it will reach its end of life within the lifespan of 22.11.

(Neo)Vim can not be configured with configure.pathogen anymore to reduce maintenance burden. Use configure.packages instead.

Neovim can not be configured with plug anymore (still works for vim).

The adguardhome module no longer uses host and port options, use settings.bind_host and settings.bind_port instead.

The default kops version is now 1.25.1 and support for 1.22 and older has been dropped.

The zrepl package has been updated from 0.5.0 to 0.6.0. See the changelog for details.

k3s no longer supports Docker as runtime due to upstream dropping support.

cassandra_2_1 and cassandra_2_2 have been removed. Please update to cassandra_3_11 or cassandra_3_0. See the changelog for more information about the upgrade process.

mysql57 has been removed. Please update to mysql80 or mariadb. See the upgrade guide for more information.

Consequently, cqrlog and amorok now use mariadb instead of mysql57 for their embedded databases. Running mysql_upgrade may be necessary.

k3s supports clusterInit option, and it is enabled by default, for servers.

percona-server56 has been removed. Please migrate to mysql or mariadb if possible.

obs-studio hase been updated to version 28. If you have packaged custom plugins, check if they are compatible. obs-websocket has been integrated into obs-studio.

signald has been bumped to 0.23.0. For the upgrade, a migration process is necessary. It can be done by running a command like this before starting signald.service:

signald -d /var/lib/signald/db \
  --database sqlite:/var/lib/signald/db \
  --migrate-data

For further information, please read the upstream changelogs.

stylua no longer accepts lua52Support and luauSupport overrides. Use features instead, which defaults to [ "lua54" "luau" ].

ocamlPackages.ocaml_extlib has been renamed to ocamlPackages.extlib.

pkgs.fetchNextcloudApp has been rewritten to circumvent impurities in e.g. tarballs from GitHub and to make it easier to apply patches. This means that your hashes are out-of-date and the (previously required) attributes name and version are no longer accepted.

The Syncthing service now only allows absolute paths—starting with / or ~/—for services.syncthing.folders.<name>.path. In a future release other paths will be allowed again and interpreted relative to services.syncthing.dataDir.

services.github-runner and services.github-runners.<name> gained the option serviceOverrides which allows overriding the systemd serviceConfig. If you have been overriding the systemd service configuration (i.e., by defining systemd.services.github-runner.serviceConfig), you have to use the serviceOverrides option now. Example:

{
  services.github-runner.serviceOverrides.SupplementaryGroups = [
    "docker"
  ];
}

PHP is now built in NTS (Non-Thread Safe) mode by default.

firefox, thunderbird and librewolf now come with Wayland support by default. The firefox-wayland, firefox-esr-wayland, thunderbird-wayland and librewolf-wayland attributes are obsolete and have been aliased to their generic attribute.

The xplr package has been updated from 0.18.0 to 0.19.0, which brings some breaking changes. See the upstream release notes for more details.

Configuring multiple GitHub runners is now possible through services.github-runners.<name>. The options under services.github-runner remain, to configure a single runner.

github-runner gained support for ephemeral runners and registrations using a personal access token (PAT) instead of a registration token. See services.github-runner.ephemeral and services.github-runner.tokenFile for details.

A new module was added to provide hardware support for the Saleae Logic device family, providing the options hardware.saleae-logic.enable and hardware.saleae-logic.package.

ZFS module will no longer allow hibernation by default.

Mastodon now automatically removes remote media attachments older than 30 days. This is configurable through services.mastodon.mediaAutoRemove.

The Redis module now disables RDB persistence when services.redis.servers.<name>.save = [] instead of using the Redis default.

Neo4j was updated from version 3 to version 4. See upstream’s migration guide for information on how to migrate your instance.

The networking.wireguard module now can set the mtu on interfaces and tag its packets with an fwmark.

The option overrideStrategy was added to the different systemd unit options (systemd.services.<name>, systemd.sockets.<name>, …) to allow enforcing the creation of a dropin file, rather than the main unit file, by setting it to asDropin. This is useful in cases where the existence of the main unit file is not known to Nix at evaluation time, for example when the main unit file is provided by adding a package to systemd.packages. See the fix proposed in NixOS’s systemd abstraction doesn’t work with systemd template units for an example.

The polymc package has been removed due to a rogue maintainer. It has been replaced by prismlauncher, a fork by the rest of the maintainers. For more details, see the PR that made this change and the issue detailing the vulnerability. Users with existing installations should rename ~/.local/share/polymc to ~/.local/share/PrismLauncher. The main config file’s path has also moved from ~/.local/share/polymc/polymc.cfg to ~/.local/share/PrismLauncher/prismlauncher.cfg.

The bloat package has been updated from unstable-2022-03-31 to unstable-2022-10-25, which brings a breaking change. See this upstream commit message for details.

Synapse’s systemd unit has been hardened.

The module services.grafana was refactored to be compliant with RFC 0042. To be precise, this means that the following things have changed:

The services.grafana.provision.alerting option was added. It includes suboptions for every alerting-related objects (with the exception of notifiers), which means it’s now possible to configure modern Grafana alerting declaratively.

Synapse now requires entries in the state_group_edges table to be unique, in order to prevent accidentally introducing duplicate information (for example, because a database backup was restored multiple times). If your Synapse database already has duplicate rows in this table, this could fail with an error and require manual remediation.

The diamond package has been update from 0.8.36 to 2.0.15. See the upstream release notes for more details.

The guake package has been updated from 3.6.3 to 3.9.0, see the changelog for more details.

The netlify-cli package has been updated from 6.13.2 to 12.2.4, see the changelog for more details.

dockerTools.buildImage’s contents parameter has been deprecated in favor of copyToRoot. Use copyToRoot = buildEnv { ... }; or similar if you intend to add packages to /bin.

The proxmox.qemuConf.bios option was added, it corresponds to Hardware->BIOS field in Proxmox web interface. Use "ovmf" value to build UEFI image, default value remains "bios". New option proxmox.partitionTableType defaults to either "legacy" or "efi", depending on the bios value. Setting partitionTableType to "hybrid" results in an image, which supports both methods ("bios" and "ovmf"), thereby remaining bootable after change to Proxmox Hardware->BIOS field.

memtest86+ was updated from 5.00-coreboot-002 to 6.00-beta2. It is now the upstream version from https://www.memtest.org/, as coreboot’s fork is no longer available.

Option descriptions, examples, and defaults writing in DocBook are now deprecated. Using CommonMark is preferred and will become the default in a future release.

The documentation.nixos.options.allowDocBook option was added to ease the transition to CommonMark option documentation. Setting this option to false causes an error for every option included in the manual that uses DocBook documentation; it defaults to true to preserve the previous behavior and will be removed once the transition to CommonMark is complete.

The Redis module now persists each instance’s configuration file in the state directory, in order to support some more advanced use cases like Sentinel.

protonup has been aliased to and replaced by protonup-ng due to upstream not maintaining it.

The udisks2 service, available at services.udisks2.enable, is now disabled by default. It will automatically be enabled through services and desktop environments as needed. This also means that polkit will now actually be disabled by default. The default for security.polkit.enable was already flipped in the previous release, but udisks2 being enabled by default re-enabled it.

Nextcloud has been updated to version 25. Additionally the following things have changed for Nextcloud in NixOS:

systemd-oomd is enabled by default. Depending on which systemd units have ManagedOOMSwap=kill or ManagedOOMMemoryPressure=kill, systemd-oomd will SIGKILL all the processes under the appropriate descendant cgroups when the configured limits are exceeded. NixOS does currently not configure cgroups with oomd by default, this can be enabled using systemd.oomd.enableRootSlice, systemd.oomd.enableSystemSlice, and systemd.oomd.enableUserServices.

The tt-rss service performs two database migrations when you first use its web UI after upgrade. Consider backing up its database before updating.

The pass-secret-service package now includes systemd units from upstream, so adding it to the NixOS services.dbus.packages option will make it start automatically as a systemd user service when an application tries to talk to the libsecret D-Bus API.

The Wordpress module now has support for installing language packs through a new option, services.wordpress.sites.<site>.languages.

The default package for services.mullvad-vpn.package was changed to pkgs.mullvad, allowing cross-platform usage of Mullvad. pkgs.mullvad only contains the Mullvad CLI tool, so users who rely on the Mullvad GUI will want to change it back to pkgs.mullvad-vpn, or add pkgs.mullvad-vpn to their environment.

PowerDNS has been updated from v4.6.2 to v4.7.2. Please be sure to review the Upgrade Notes provided by upstream before upgrading. Worth specifically noting is that the new Catalog Zones feature comes with a mandatory schema change for the GSQL database backends, which has to be manually applied.

There is a new module for the thunar program (the Xfce file manager), which depends on the xfconf dbus service, and also has a dbus service and a systemd unit. The option services.xserver.desktopManager.xfce.thunarPlugins has been renamed to programs.thunar.plugins, and may be removed in a future release.

There is a new module for xfconf (the Xfce configuration storage system), which has a dbus service.

The Mastodon package has been upgraded to v4.0.0. See the v4.0.0 release notes for a list of changes. On standard setups, no manual migration steps are required. Nevertheless, a database backup is recommended.

The nomad package now defaults to v1.3, which no longer has a downgrade path to v1.2 or older.

The nodePackages package set now defaults to the LTS release in the nodejs package again, instead of being pinned to nodejs-14_x. Several updates to node2nix have been made for compatibility with newer Node.js and npm versions and a new postRebuild hook has been added for packages to perform extra build steps before the npm install step prunes dev dependencies.

boot.kernel.sysctl is defined as a freeformType and adds a custom merge option for net.core.rmem_max (taking the highest value defined to avoid conflicts between 2 services trying to set that value).

The mame package does not ship with its tools anymore in the default output. They were moved to a separate tools output instead. For convenience, mame-tools package was added for those who want to use it.

A NixOS module for Firefox has been added which allows preferences and policies to be set. This also allows extensions to be installed via the ExtensionSettings policy. The new options are under programs.firefox.

The option services.picom.experimentalBackends was removed since it is now the default and the option will cause picom to quit instead.

haskellPackages.callHackage is not always invalidated if all-cabal-hashes changes, leading to less rebuilds of haskell dependencies.

haskellPackages.callHackage and haskellPackages.callCabal2nix (and related functions) no longer keep a reference to the cabal2nix call used to generate them. As a result, they will be garbage collected more often.

alps, a simple and extensible webmail. Available as services.alps.

appvm, Nix based app VMs. Available as virtualisation.appvm.

AusweisApp2, the authentication software for the German ID card. Available as programs.ausweisapp.

automatic-timezoned. a Linux daemon to automatically update the system timezone based on location. Available as services.automatic-timezoned.

Dolibarr, an enterprise resource planning and customer relationship manager. Enable using services.dolibarr.

dragonflydb, a modern replacement for Redis and Memcached. Available as services.dragonflydb.

endlessh-go, an SSH tarpit that exposes Prometheus metrics. Available as services.endlessh-go.

endlessh, an SSH tarpit. Available as services.endlessh.

EVCC is an EV charge controller with PV integration. It supports a multitude of chargers, meters, vehicle APIs and more and ties that together with a well-tested backend and a lightweight web frontend. Available as services.evcc.

expressvpn, the CLI client for ExpressVPN. Available as services.expressvpn.

FreshRSS, a free, self-hostable RSS feed aggregator. Available as services.freshrss.

Garage, a simple object storage server for geodistributed deployments, alternative to MinIO. Available as services.garage.

go-autoconfig, IMAP/SMTP autodiscover server. Available as services.go-autoconfig.

Grafana Tempo, a distributed tracing store. Available as services.tempo.

HBase cluster, a distributed, scalable, big data store. Available as services.hadoop.hbase.

infnoise, a hardware True Random Number Generator dongle. Available as services.infnoise.

kanata, a tool to improve keyboard comfort and usability with advanced customization. Available as services.kanata.

karma, an alert dashboard for Prometheus Alertmanager. Available as services.karma

Komga, a free and open source comics/mangas media server. Available as services.komga.

kthxbye, an alert acknowledgement management daemon for Prometheus Alertmanager. Available as services.kthxbye

languagetool, a multilingual grammar, style, and spell checker. Available as services.languagetool.

Listmonk, a self-hosted newsletter manager. Enable using services.listmonk.

Mepo, a fast, simple, hackable OSM map viewer for mobile and desktop Linux. Available as programs.mepo.enable.

merecat, a small and easy HTTP server based on thttpd. Available as services.merecat

netbird, a zero configuration VPN. Available as services.netbird.

ntfy.sh, a push notification service. Available as services.ntfy-sh

OpenRGB, a FOSS tool for controlling RGB lighting. Available as services.hardware.openrgb.enable.

Outline, a wiki and knowledge base similar to Notion. Available as services.outline.

Patroni, a template for PostgreSQL HA with ZooKeeper, etcd or Consul. Available as services.patroni.