Table of Contents
This section lists the release notes for each stable version of Nixpkgs and current unstable revision.
This release of Nixpkgs requires macOS Big Sur 11.3 or newer, as announced in the 24.11 release notes. We cannot guarantee that packages will continue to work on older versions of macOS. Future Nixpkgs releases will only support macOS versions supported by Apple; this means that Nixpkgs 25.11 will require macOS Sonoma 14 or newer. Users on old macOS versions should consider upgrading to a supported version (potentially using OpenCore Legacy Patcher for old hardware) or installing NixOS. If neither of those options are viable and you require new versions of software, MacPorts supports versions back to Mac OS X Snow Leopard 10.6.
The default kernel package has been updated from 6.6 to 6.12. All supported kernels remain available.
GCC has been updated from GCC 13 to GCC 14. This introduces some backwards‐incompatible changes; see the upstream porting guide for details.
The default GHC version has been updated from 9.6 to 9.8.
haskellPackages
also uses Stackage LTS 23 (instead of LTS 22) as a baseline.
We aim to remove the old GHC versions 8.10, 9.0 and 9.2 in the next release in accordance with the new GHC deprecation policy.
LLVM has been updated from LLVM 16 (on Darwin) and LLVM 18 (on other platforms) to LLVM 19. This introduces some backwards‐incompatible changes; see the upstream release notes for details.
The Factor programming language packages were reworked. factor-lang-scope
is now named factorPackages
and provides a buildFactorApplication
function to deploy Factor programs as binaries. It has also received proper documentation in the Nixpkgs manual.
Emacs has been updated to 30.1.
This introduces some backwards‐incompatible changes; see the NEWS for details.
NEWS can been viewed from Emacs by typing C-h n
, or by clicking Help->Emacs News
from the menu bar.
It can also be browsed online.
The default openexr version has been updated to 3.2.4.
The default PHP version has been updated to 8.4.
The default Erlang OTP version has been updated to 27.
The default Elixir version has been updated to 1.18.
apptainer
and singularity
deprecate the workaround of overriding vendorHash
and related attributes via <pkg>.override
,
in favour of the unified overriding of the same group of attributes via <pkg>.overrideAttrs
.
The compatibility layer will be removed in future releases.
squid
has been updated to version 7, this release includes multiple breaking changes, like ESI removal.
For more information, check the release notes.
postgresql
and libpq
don’t provide pg_config
by default anymore. Instead, pg_config
is available via postgresql.pg_config
or libpq.pg_config
. This allowed implementing it as a shell script, which can be built for both the build and host systems when cross-compiling. If your build fails to find pg_config
, add postgresql.pg_config
or libpq.pg_config
to nativeBuildInputs
.
The no-broken-symlinks
hook was added to catch builds containing dangling or reflexive symlinks, as these are indicative of problems with packaging.
The hook can be disabled by providing dontCheckForBrokenSymlinks = true;
as an argument to mkDerivation
.
For more information, check the docs or see this PR.
opensmtpd-extras
has been deprecated by upstream and is not compatible with
OpenSMTPD 7.6.0 or later. The package has been removed in favor of a set of new
opensmtpd-table-*
packages.
postsrsd
upgraded to >= 2.0.0
, with some different behaviors and
configuration settings. Notably, it now defaults to listening on a socket
rather than a port. See Migrating from version 1.x and Postfix Setup for details.
The hand written perlPackages.SearchXapian
bindings have been dropped in favor of the (mostly compatible)
perlPackages.Xapian
.
The config
triple for aarch64-darwin
has been changed from aarch64-apple-darwin
to arm64-apple-darwin
to match the Apple toolchain and LLVM’s expectations.
The electron
packages will now provide their headers (available via electron.headers
) in extracted form instead of in a tarball.
The ephemeral
package was removed due to upstream archival in early 2022.
The vocal
package was removed due to upstream archival. The upstream developer suggests using gnome-podcasts
or kasts
instead.
testers.shellcheck now warns when name
is not provided.
The name
argument will become mandatory in a future release.
GIMP 3.0 available as gimp3
.
grafana-agent
and services.grafana-agent
have been removed in favor of
Grafana Alloy (grafana-alloy
and services.alloy
), as they depend on an EOL compiler version
and will become EOL during the 25.05 lifecycle.
Grafana recommends migrating to grafana-alloy
(services.alloy
).
See https://grafana.com/docs/alloy/latest/set-up/migrate/ for details.
xdragon
package has been renamed to dragon-drop
.
xdragon
is an alias to dragon-drop
and the package still provides bin/xdragon
.
bin/dragon
is no longer supplied.
The nixLog*
family of functions made available through the standard environment have been rewritten to prefix messages with both the debug level and the function name of the caller.
The nixLog
function, which logs unconditionally, was also re-introduced and modified to prefix messages with the function name of the caller.
For more information, see this PR.
postgresql
’s pythonSupport
argument has been changed. It is now enabled by default, but to use PL/Python the extension needs to be added explicitly with postgresql.withPackages
. If you were using postgresql.override { pythonSupport = true; }
before, change it to postgresql.withPackages (ps: [ ps.plpython3 ])
. The same applies to perlSupport
/plperl
and tclSupport
/pltcl
respectively.
Rust packages will need to regenerate their cargoHash
.
Cargo 1.84.0 changed the format of cargo vendor
output, which invalidated all existing rustPlatform.fetchCargoTarball
hashes.
To preserve Nix’s invariants, it has been replaced with rustPlatform.fetchCargoVendor
, an independent implementation prioritizing format stability.
rustPlatform.buildRustPackage
now uses rustPlatform.fetchCargoVendor
by default; a hash mismatch error is expected in third‐party Rust packages when updating to Nixpkgs 25.05.
Packages wishing to maintain compatibility with Nixpkgs 24.11 must set useFetchCargoVendor
to true
explicitly.
rustPlatform.importCargoLock
may also be appropriate in some circumstances.
cassandra_3_0
and cassandra_3_11
have been removed as they have reached end-of-life. Please update to cassandra_4
. See the changelog for more information about the upgrade process.
mariadb_105
has been removed as it has reached end-of-life in 2025-06. Please update to mariadb_106
.
NetBox was updated to >= 4.2.0
. Have a look at the breaking changes
of the 4.1 release
and the 4.2 release,
make the required changes to your database, if needed, then upgrade by setting services.netbox.package = pkgs.netbox_4_2;
in your configuration.
NetBox version 4.0.X available as netbox_4_0
was removed. Please upgrade to 4.2
.
golangci-lint
has reached v2
. Please read the changes and view the migration guide here.
i3status-rust
-package no longer enables notmuch
by default. It can be enabled via withNotmuch
.
ocis-bin
has been renamed to ocis_5-bin
. Future versions will have the major version suffix.
All support for 32‐bit Darwin systems has been dropped.
substituteAll
and substituteAllFiles
have been deprecated in favor of replaceVars
and will be removed in the next release.
Default ICU version updated from 74 to 76
The packages signald
, signaldctl
and purple-signald
have been dropped as they are unmaintained upstream and have been incompatible with the official Signal servers for a long while.
Apache Kafka was updated to >= 4.0.0
. Please note that this is the first release which operates
entirely without Apache ZooKeeper support, and all clusters need to be migrated to KRaft mode. See
the release announcement
for more details.
ast-grep
remove sg
command to prevent conflict with sg
command from shadow-utils. If you need legacy sg command compatibility with old code, you can use ast-grep.override { enableLegacySg = true; }
rename package wtf
to wtfutil
.
python3Packages.beancount
was updated to 3.1.0. Previous major version remains available as python3Packages.beancount_2
.
wastebin
has been updated to 3.0.0. See the Changelog for breaking changes to the configuration.
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.
pkgs.nextcloud28
and pkgs.nextcloud29
have been removed since they are out of support upstream.
centrifugo
was updated to v6, which uses a new config format. See upstream documentation for migration.
teleport
has been upgraded from major version 16 to major version 17.
Refer to upstream upgrade instructions
and release notes for v17.
Emacs lisp build helpers, such as emacs.pkgs.melpaBuild
, now enables __structuredAttrs
by default.
Environment variables have to be passed via the env
attribute.
buildGoModule
now passes environment variables via the env
attribute. CGO_ENABLED
should now be specified with env.CGO_ENABLED
when passing to buildGoModule. Direct specification of CGO_ENABLED
is now redirected by a compatibility layer with a warning, but will become an error in future releases.
Go-related environment variables previously shadowed by buildGoModule
now results in errors when specified directly. Such variables include GOOS
and GOARCH
.
Third-party projects supporting both stable and unstable channels could detect this change through the absence of the CGO_ENABLED
function argument in buildGoModule
(!((lib.functionArgs buildGoModule) ? CGO_ENABLED)
).
buildGoPackage
has been removed. Use buildGoModule
instead. See the Go section in the nixpkgs manual for details.
buildGoModule
now supports a goSum
attribute (null
by default) to optionally provide a path to go.sum
and correctly enabling rebuilds when the file changes.
top-level playwright
now refers to the github Microsoft/playwright package
instead of the python tester launcher. You can still refer to the python
launcher via python3Packages.toPythonApplication python3Packages.playwright
The representation of the flags attributes as shell/environment variables for most Python building setup hooks are now the same as stdenv.mkDerivation
and other build helpers – they are space-separated environment variables when __structuredAttrs = false
and Bash arrays when __structuredAttrs = true
, and are concatenated to the command without Bash-evaluation. The following behaviour changes are introduced during the conversion:
The following flags are no longer Bash-expanded before concatenated to the command:
disabledTests
and disabledTestPaths
for pytestCheckHook
. (disabledTestPaths
used to be expanded twice before concatenation.)
setupPyBuildFlags
and setupPyGlobalFlags
for setuptoolsBuildHook
.
pytestFlags
and unittestFlags
replace pytestFlagsArray
and unittestFlagsArray
and become the new and conforming interface.
pytestFlagsArray
and unittestFlagsArray
are kept for compatibility purposes. They continue to be Bash-expanded before concatenated. This compatibility layer will be removed in future releases.
The haka
package and module has been removed because the package was broken and unmaintained for 9 years.
The gsignond
package, plugins and module have been removed because they were unmaintained for 6 years.
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.
nezha
and its agent nezha-agent
have been updated to v1, which contains breaking changes. See the official wiki for more details.
ps3-disc-dumper
was updated to 4.2.5, which removed the CLI project and now exclusively offers the GUI
kmonad
is now hardened by default using common systemd
settings.
If KMonad is used to execute shell commands, hardening may make some of them fail. In that case, you can disable hardening using services.kmonad.keyboards.<name>.enableHardening
option.
isd
was updated from 0.2.0 to 0.5.1, the new version may crash with a previously generated config, try moving or deleting ~/.config/isd/schema.json
.
uwsgi
no longer supports Python 2 plugins.
Support for CUDA 10 has been dropped, as announced in the 24.11 release notes.
mepo
was updated to version 1.3.3. The manual page was removed,
a new JSON API was introduced to replace Mepolang for configuration,
and a few default key bindings were changed.
See the 1.3.0 changelog
for more details.
mkBinaryCache
now defaults to using zstd
compression for the binary caches it creates. The previous xz
compression method can be used by passing compression = "xz";
.
nodejs_latest
was updated from 23.x to 24.x. nodejs_23
has been removed in favor of nodejs_24
.
nodejs_18
package was removed due to upstream End-of-Life in April 2025.
nodePackages."@commitlint/config-conventional"
has been removed, as it is a library, and projects should depend on it instead.
zigbee2mqtt is now available in version 2.x as zigbee2mqtt_2
. In NixOS 25.11 we’ll remove zigbee2mqtt_1
and default to zigbee2mqtt_2
. See the breaking changes announcement for 2.0.0.
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.
nodePackages.copy-webpack-plugin
has been removed, as it should be installed in projects that use it instead.
himalaya
has been updated from v1.0.0-beta.4
to v1.1.0
, which introduces breaking changes. Check out the release notes for details.
linuxPackages.nvidiaPackages.dc_520
has been removed since it is marked broken and there are better newer alternatives.
pnpm
was updated to version 10. If your project is incompatible, you can install the previous version from the package attribute pnpm_9
.
dwarf-fortress-packages
now only contains one minor version for each major version since version 0.44. Saves should still be compatible, but you may have to change which minor version you were using if it was one other than the newest.
tpm2-pkcs11
now is compiled without abrmd (Access Broker and Resource Manager Daemon) support by default, preferring the kernel resource manager. Use tpm2-pkcs11.abrmd
if you would like a version with abrmd support. Note that the NixOS module picks the correct one automatically based on security.tpm2.abrmd
.
zig_0_9
and zig_0_10
have been removed, you should upgrade to zig_0_13
(also available as just zig
), zig_0_12
or zig_0_11
instead.
webpack-cli
was updated to major version 6, which has breaking changes from the previous version 5.1.4. See the upstream release notes for details on these changes.
minetest
has been renamed to luanti
to match the upstream name change but aliases have been added. The new name hasn’t resulted in many changes as of yet but older references to minetest should be sunset. See the new name announcement for more details.
poac
has been renamed to cabinpkg
to match the upstream name change but an alias has been added. See the new name announcement for more details.
serious-sans
has been removed because upstream changed its name to Serious Shanns, which is not currently packaged.
racket_7_9
has been removed, as it is insecure. It is recommended to use Racket 8 instead.
rofi
has been updated from 1.7.5 to 1.7.6 which introduces some breaking changes to binary plugins, and also contains a lot of new features and bug fixes. This is highlighted because the patch version bump does not indicate the volume of changes by itself. See the upstream release notes for the full list of changes.
ente-auth
now uses the name enteauth
for its binary. The previous name was ente_auth
.
foundationdb
was upgraded to 7.3.
fluxus
has been removed, as it depends on racket_7_9
and had no updates in 9 years.
meilisearch
has been upgraded from 1.11.3 to 1.14.0, which requires manually dumping and importing the data.
See Meilisearch’s upgrade guide for more information.
sm64ex-coop
has been removed as it was archived upstream. Consider migrating to sm64coopdx
.
tldr
now uses tldr-python-client
instead of tldr-c-client
which is unmaintained.
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.
python3Packages.bpycv
has been removed due to being incompatible with Blender 4 and unmaintained.
python3Packages.jaeger-client
was removed because it was deprecated upstream. OpenTelemetry is the recommended replacement.
nodePackages.meshcommander
has been removed, as the package was deprecated by Intel.
The default version of z3
has been updated from 4.8 to 4.15, and all old versions have been dropped. Note that fstar
still depends on specific versions, and maintains them as overrides.
prometheus
has been updated from 2.55.0 to 3.1.0.
Read the release blog post and
migration guide.
kanata
was updated to v1.8.0, which introduces several breaking changes.
See the release notes of
v1.7.0 and
v1.8.0
for more information.
authelia
version 4.39.0 has made changes on the default claims for ID Tokens, to mirror the standard claims from the specification.
This change may affect some clients in unexpected ways, so manual intervention may be required.
Read the release notes, along with the guide to work around issues that may be encountered.
ags
was updated to v2, which is just a CLI for Astal now. Components are available as a different package set astal.*
.
If you want to use v1, it is available as ags_1
package.
See the release notes of v2.0.0 for more information.
nodePackages.expo-cli
has been removed, as it was deprecated by upstream. The suggested replacement is the npx expo
command.
open-policy-agent
has has been updated to 1.0.0+.
This major release makes the rego.v1
syntax the default.
This is a breaking change for those using v0 Rego.
See the upgrade documentation for more details.
For those unable to upgrade yet, there is a v0 compatibility mode
available too.
helmfile
was updated to v1.0.0, which introduces several breaking changes.
See the release notes of
v1.0.0 for more
information.
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.
borgmatic
has been updated from 1.8.14 to 1.9.5, please check the upstream changelog for more details, especially for a few possibly breaking changes noted in the 1.9.0 changelog.
nodePackages.ganache
has been removed, as the package has been deprecated by upstream.
matomo
now defaults to version 5 (previously available as matomo_5
). Version 4 has been removed as it reached EOL on December 19, 2024.
matomo-beta
has been removed as the version of the matomo
package can now be easily overridden through overrideAttrs
(see PR #374022)
docker_24
has been removed, as it was EOL with vulnerabilities since June 08, 2024.
Emacs 28 and 29 have been removed.
Emacs 28 Macport has been removed, while CVEs of Emacs 29 Macport are patched.
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.
python3Packages.opentracing
has been removed due to being unmaintained upstream. OpenTelemetry is the recommended replacement.
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.7.0, which
introduces several breaking changes. See the
Prisma ORM upgrade guide
for more information.
dependency-track
no longer bundes the UI inside the jar. This bundling
functionality is deprecated by upstream and causes UI assets not being served
after weeks of runtime.
nq
was updated to 1.0, which renames the fq
and tq
utilities to nqtail
and nqterm
respectively.
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.
confluent-cli
was updated from 3.60.0 to 4.16.0, which includes several breaking changes as detailed in Confluent’s release notes.
siduck76-st
has been renamed to st-snazzy
, like the project’s flake.
python3Packages.jax
now directly depends on python3Packages.jaxlib
.
As a result, packages that depend on jax no longer need to include jaxlib to their dependencies.
There is also a breaking change in the handling of CUDA. Instead of using a CUDA compatible jaxlib
as before, you can use plugins like python3Packages.jax-cuda12-plugin
.
i18n
module improvements:
i18n.extraLocales
should now be the preferred way to install additional locales.
i18n.supportedLocales
is now considered an implementation detail and will be hidden from the documentation. But the option will still continue to work.
i18n.supportedLocales
will now trigger a warning when it omits any locale set in i18n.defaultLocale
, i18n.extraLocales
or i18n.extraLocaleSettings
.
The options i18n.defaultCharset
& i18n.localeCharsets
were added, and they complement i18n.defaultLocale
& i18n.extraLocaleSettings
respectively - allowing to control the character set used per locale setting.
titaniumenv
, titanium
, and titanium-alloy
have been removed due to lack of maintenance in Nixpkgs .
androidenv has been improved:
All versions specified in composeAndroidPackages now track the latest. Android packages are automatically updated on unstable, and run the androidenv test suite on every update.
Many androidenv packages are now searchable on search.nixos.org.
We now use the latest Google repositories, which should improve aarch64-darwin compatibility. The SDK now additionally evaluates on aarch64-linux, though not all packages are functional.
dwarf-fortress
audio now works again. Additionally, the dfhack
and dwarf-fortress-full
packages are now exposed at toplevel, making it easier to install and play Dwarf Fortress. Note that dwarf-fortress-full
is the Nixpkgs equivalent of the Dwarf Fortress Lazy Pack.
gerbera
now has wavpack support.
GOverlay has been updated to 1.2, please check the upstream changelog for more details.
tpm2-pkcs11
now has the variant tpm2-pkcs11-fapi
, which has been patched to default to the Feature API backend. It has also been split into tpm2-pkcs11-esapi
, which only supports the older Enhanced System API backend. Note the differences, and that tpm2-pkcs11
itself still needs TPM2_PKCS11_BACKEND=fapi
exported in order to use the Feature API, whereas tpm2-pkcs11-fapi
does not, and tpm2-pkcs11-esapi
just does not support fapi entirely.
For matrix homeserver Synapse we are now following the upstream recommendation to enable jemalloc as the memory allocator by default.
In dovecot
package removed hard coding path to module directory.
signal-desktop
has been migrated to a from source build. No state migration is necessary. In case there’s no working source build available (like on Darwin), the the binary build is still available at signal-desktop-bin
.
ddclient
was updated from 3.11.2 to 4.0.0 Release notes
nexusmods-app
has been upgraded from version 0.6.3 to 0.10.2.
Before upgrading, you must reset all app state (mods, games, settings, etc). NexusMods.App will crash if any state from a version older than 0.7.0 is still present.
Typically, you can can reset to a clean state by running NexusMods.App uninstall-app
. See Nexus Mod’s how to uninstall the app documentation for more detail and alternative methods.
This should not be necessary going forward, because loading app state from 0.7.0 or newer is now supported. This is documented in the 0.7.1 changelog.
Structure of the functor
of some types has changed. functor
is an implementation detail and should not be relied upon. If you did rely on it let us know in this PR.
lib.types.enum
: Previously the functor.payload
was the list of enum values directly. Now it is an attribute set containing the values in the values
attribute.
lib.types.separatedString
: Previously the functor.payload
was the separator directly. Now it is an attribute set containing the separator in the sep
attribute.
The tinycc
package now has the dev
, doc
and lib
outputs, thus,
tinycc.out
may now only provide the tcc and cross compilers binaries.
The virtualisation.hypervGuest.videoMode
option has been removed. Standard tooling can now be used to configure display modes for Hyper-V VMs.
[lib.packagesFromDirectoryRecursive
] now rejects unknown arguments.
[lib.packagesFromDirectoryRecursive
]: https://nixos.org/manual/nixpkgs/stable/#function-library-lib.filesystem.packagesFromDirectoryRecursive
The godot-export-templates
package now has its content at share/godot/export_templates/$version
instead of the output root. This makes it more convenient for for symlinking into ~/.local
, but scripts expecting the old layout will need to be changed.
functor
is an implementation detail and should not be relied upon, but since its status wasn’t clear and it has had some use cases without alternatives, changes are being handled as gracefully as possible. Deprecations within functor:
functor.wrapped
is now deprecated for some types and using it will give a warning with migration instructions. It is deprecated for these types:
lib.types.attrsWith
lib.types.listOf
lib.types.unique
and lib.types.uniq
lib.types.nullOr
lib.types.functionTo
lib.types.coercedTo
lib.types.either
The testTarget
argument of haskellPackages.mkDerivation
has been deprecated in favour of testTargets
.
testTarget
took a space separated string of targets, whereas the new testTargets
argument takes a list of targets.
For instance, testTarget = "foo bar baz"
should become testTargets = [ "foo" "bar" "baz" ]
.
Plasma 5 and Qt 5 based versions of associated software are deprecated in NixOS 25.05, and will be removed in NixOS 25.11. Users are encouraged to upgrade to Plasma 6.
rustPlatform.buildRustPackage
stops handling the deprecated argument cargoSha256
. Out-of-tree packages that haven’t migrated from cargoSha256
to cargoHash
now receive errors.
[lib.packagesFromDirectoryRecursive
] can now construct nested scopes matching the directory tree passed as input.