63 KiB
Release 24.05 (“Uakari”, 2024.05/??)
Support is planned until the end of December 2024, handing over to 24.11.
Highlights
In addition to numerous new and upgraded packages, this release has the following highlights:
-
cryptsetuphas 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 withcryptsetup. It has a lot of caveats, see the above notes for the full details. -
screen's module has been cleaned, and will now require you to setprograms.screen.enablein order to populatescreenrcand add the program to the environment. -
linuxPackages_testing_bcachefsis now fully deprecated bylinuxPackages_latest, and is therefore no longer available. -
The default kernel package has been updated from 6.1 to 6.6. All supported kernels remain available.
-
NixOS now installs a stub ELF loader that prints an informative error message when users attempt to run binaries not made for NixOS.
- This can be disabled through the
environment.stub-ld.enableoption. - If you use
programs.nix-ld.enable, no changes are needed. The stub will be disabled automatically.
- This can be disabled through the
-
On flake-based NixOS configurations using
nixpkgs.lib.nixosSystem, NixOS will automatically setNIX_PATHand the system-wide flake registry (/etc/nix/registry.json) to point<nixpkgs>and the unqualified flake pathnixpkgsto the version of nixpkgs used to build the system.This makes
nix run nixpkgs#helloandnix-build '<nixpkgs>' -A hellowork 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 this, set nixpkgs.flake.setNixPath and nixpkgs.flake.setFlakeRegistry to false.
-
nixVersions.unstablewas removed. Instead the following attributes are provided:nixVersions.gitwhich tracks the latest Nix master and is roughly updated once a week. This is intended to enable people to easily test unreleased changes of Nix to catch regressions earlier.nixVersions.latestwhich points to the latest Nix version packaged in nixpkgs.
-
juliaenvironments can now be built with arbitrary packages from the ecosystem using the.withPackagesfunction. For example:julia.withPackages ["Plots"]. -
pipewireandwireplumbermodules have removed support for usingenvironment.etc."pipewire/..."andenvironment.etc."wireplumber/...". Useservices.pipewire.extraConfigorservices.pipewire.configPackagesfor PipeWire andservices.pipewire.wireplumber.configPackagesfor WirePlumber instead." -
teleporthas been upgraded from major version 14 to major version 15. Refer to upstream upgrade instructions and release notes for v15. -
systemd.sysusers.enableoption was added. If enabled, users and groups are created with systemd-sysusers instead of with a custom perl script. -
virtualisation.docker.enableNvidiaandvirtualisation.podman.enableNvidiaoptions are deprecated.hardware.nvidia-container-toolkit.enableshould be used instead. This option will expose GPUs on containers with the--deviceCLI 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. -
system.etc.overlay.enableoption was added. If enabled,/etcis mounted via an overlayfs instead of being created by a custom perl script. -
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 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 integration the data into the NixOS homepage. The list in
nixos/modules/virtualisation/amazon-ec2-amis.nixwill 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" ]; } -
virtialisation.incusnow defaults to the newly-addedincus-ltsrelease (v6.0.x). Users who wish to continue using the non-LTS release will need to setvirtualisation.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. -
Canonical
lxdhas 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. -
luainterpreters default LUA_PATH and LUA_CPATH are not overriden by nixpkgs anymore, we patch LUA_ROOT instead which is more respectful to upstream. -
plasma6is now available and can be installed withservices.xserver.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. -
lomiri(formerly known as Unity8) desktop mode, using Mir 2.x to function as a Wayland compositor, is now available and can be installed withservices.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.
New Services
-
ownCloud Infinite Scale Stack, a modern and scalable rewrite of ownCloud.
-
Handheld Daemon, support for gaming handhelds like the Legion Go, ROG Ally, and GPD Win. Available as services.handheld-daemon.
-
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.
-
Guix, a functional package manager inspired by Nix. Available as services.guix.
-
Flarum, a delightfully simple discussion platform for your website. Available as services.flarum.
-
PhotonVision, a free, fast, and easy-to-use computer vision solution for the FIRST® Robotics Competition.
-
clatd, a CLAT / SIIT-DC Edge Relay implementation for Linux.
-
pyLoad, a FOSS download manager written in Python. Available as services.pyload.
-
maubot, a plugin-based Matrix bot framework. Available as services.maubot.
-
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. -
systemd'sgateway,upload, andremoteservices, which provide ways of sending journals across the network. Enable using services.journald.gateway, services.journald.upload, and services.journald.remote. -
GNS3, a network software emulator. Available as services.gns3-server.
-
pretalx, a conference planning tool. Available as services.pretalx.
-
dnsproxy, a simple DNS proxy with DoH, DoT, DoQ and DNSCrypt support. Available as services.dnsproxy.
-
manticoresearch, easy to use open source fast database for search. Available as services.manticore.
-
rspamd-trainer, script triggered by a helper which reads mails from a specific mail inbox and feeds them into rspamd for spam/ham training.
-
ollama, server for running large language models locally.
-
Mihomo, a rule-based proxy in Go. Available as services.mihomo.enable.
-
hebbot, a Matrix bot to generate "This Week in X" like blog posts. Available as services.hebbot.
-
Workout-tracker, a workout tracking web application for personal use.
-
Python Matter Server, a Matter Controller Server exposing websocket connections for use with other services, notably Home Assistant. Available as services.matter-server.
-
db-rest, a wrapper around Deutsche Bahn's internal API for public transport data. Available as services.db-rest.
-
mautrix-signal, a Matrix-Signal puppeting bridge. Available as services.mautrix-signal.
-
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 anki-sync-server software.
-
mautrix-meta, a Matrix <-> Facebook and Matrix <-> Instagram hybrid puppeting/relaybot bridge. Available as services.mautrix-meta.
-
Jottacloud Command-line Tool, a CLI for the Jottacloud cloud storage provider. Available as services.jotta-cli.
-
transfer-sh, a tool that supports easy and fast file sharing from the command-line. Available as services.transfer-sh.
-
FCast Receiver, an open-source alternative to Chromecast and AirPlay. Available as programs.fcast-receiver.
-
MollySocket which allows getting Signal notifications via UnifiedPush.
-
Suwayomi Server, a free and open source manga reader server that runs extensions built for Tachiyomi. Available as services.suwayomi-server.
-
Netbird, an open-source VPN management platform, now has a self-hosted management server. Available as services.netbird.server.
-
ping_exporter, a Prometheus exporter for ICMP echo requests. Available as services.prometheus.exporters.ping.
-
Prometheus DNSSEC Exporter, check for validity and expiration in DNSSEC signatures and expose metrics for Prometheus. Available as services.prometheus.exporters.dnssec.
-
TigerBeetle, a distributed financial accounting database designed for mission critical safety and performance. Available as services.tigerbeetle.
-
go-camo, a secure image proxy server. Available as services.go-camo.
-
CommaFeed, a Google Reader inspired self-hosted RSS reader. Available as services.commafeed.
-
Monado, an open source XR runtime. Available as services.monado.
-
intel-gpu-tools, tools for development and testing of the Intel DRM driver. Available as hardware.intel-gpu-tools.
-
Pretix, an open source ticketing software for events. Available as services.pretix.
-
microsocks, a tiny, portable SOCKS5 server with very moderate resource usage. Available as services.microsocks.
-
inadyn, a Dynamic DNS client with built-in support for multiple providers. Available as services.inadyn.
-
Clevis, a pluggable framework for automated decryption, used to unlock encrypted devices in initrd. Available as boot.initrd.clevis.enable.
-
fritz-exporter, a Prometheus exporter for extracting metrics from FRITZ! devices. Available as services.prometheus.exporters.fritz.
-
armagetronad, a mid-2000s 3D lightcycle game widely played at iD Tech Camps. You can define multiple servers using
services.armagetronad.<server>.enable. -
wyoming-satellite, a voice assistant satellite for Home Assistant using the Wyoming protocol. Available as services.wyoming.satellite.
-
TuxClocker, a hardware control and monitoring program. Available as programs.tuxclocker.
-
AppImage, a tool to package desktop applications, now has a
binfmtoption to support running AppImages seamlessly on NixOS. Available as programs.appimage.binfmt. -
nh, yet another Nix CLI helper. Available as programs.nh.
-
ALVR, a VR desktop streamer. Available as programs.alvr.
-
xdg-terminal-exec, the proposed Default Terminal Execution Specification.
-
your_spotify, a self hosted Spotify tracking dashboard. Available as services.your_spotify
-
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.
-
Scrutiny, a S.M.A.R.T monitoring tool for hard disks with a web frontend. Available as services.scrutiny.
-
davis, a simple CardDav and CalDav server inspired by Baïkal. Available as services.davis.
-
Firefly-iii, a free and open source personal finance manager. Available as services.firefly-iii.
-
systemd-lock-handler, a bridge between logind D-Bus events and systemd targets. Available as services.systemd-lock-handler.enable.
-
wastebin, a pastebin server written in rust. Available as services.wastebin.
-
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.
-
Sunshine, a self-hosted game stream host for Moonlight. Available as services.sunshine.
-
Uni-Sync, a synchronization tool for Lian Li Uni Controllers. Available as hardware.uni-sync.
-
prometheus-nats-exporter, a Prometheus exporter for NATS. Available as services.prometheus.exporters.nats.
-
isolate, a sandbox for securely executing untrusted programs. Available as security.isolate.
-
ydotool, a generic command-line automation tool now has a module. Available as programs.ydotool.
-
private-gpt, a service to interact with your documents using the power of LLMs, 100% privately, no data leaks. Available as services.private-gpt.
-
keto, a permission & access control server, the first open source implementation of "Zanzibar: Google's Consistent, Global Authorization System".
Backward Incompatibilities
-
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) and present to help you migrate to the latest supported version. See changelog and upgrade notes for more information. -
himalayawas updated to v1.0.0-beta.4, which introduces breaking changes. Check out the release note for details. -
security.pam.enableSSHAgentAuthwas replaced by thesshAgentAuthattrset, and onlyauthorized_keysfiles listed insshAgentAuth.authorizedKeysFilesare trusted, defaulting to/etc/ssh/authorized_keys.d/%u. ::: {.warning} Users of {manpage}pam_ssh_agent_auth(8)must take care that the pubkeys they use (for instance withsudo) are listed insshAgentAuth.authorizedKeysFiles. ::: ::: {.note} Previously, allservices.openssh.authorizedKeysFileswere trusted, including~/.ssh/authorized_keys, which results in an insecure configuration; see #31611. :::
-
The
power.upsmodule now generatesupsd.conf,upsd.usersandupsmon.confautomatically from a set of new configuration options. This breaks compatibility with existingpower.upssetups where these files were created manually. Back up these files before upgrading NixOS. -
programs.nix-ld.librariesno longer setsbaseLibrariesvia the option's default but in config and now merges any additional libraries with the default ones. This means thatlib.mkForcemust be used to clear the list of default libraries. -
cudaPackages.autoAddOpenGLRunpathHookandcudaPackages.autoAddDriverRunpathhave been deprecated forpkgs.autoAddDriverRunpath. Functionality has not changed, but the setuphook has been renamed and moved to the top-level package scope. -
cudaPackages.autoFixElfFileshas been deprecated forpkgs.autoFixElfFiles. Functionality has not changed, but the setuphook has been renamed and moved to the top-level package scope. -
appimageTools.wrapAppImagenow creates the binary at$out/bin/${pname}rather than$out/bin/${pname}-${version}, which will break downstream workarounds. -
pdnswas updated to version v4.9.x, which introduces breaking changes. Check out the Upgrade Notes for details. -
unrarwas updated to v7. See changelog for more information. -
percona-servernow 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-serverdefaults topercona-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 attributepercona-server_8_0. Thepercona-server_innovationreleases 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 supportingpercona-xtrabackuptool as well. -
git-townwas updated from version 11 to 13. See the changelog for breaking changes. -
k9swas 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. -
the .csv format used to define lua packages to be updated via
luarocks-packages-updaterhas changed:src(URL towards a git repository) has now becomerockspec(URL towards a rockspec) to remove ambiguity regarding which rockspec to use and simplify implementation. -
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 integration the data into the NixOS homepage. The list in
nixos/modules/virtualisation/amazon-ec2-amis.nixwill stop being updated and will be removed in the future. -
The option
services.postgresql.ensureUsers._.ensurePermissionshas been removed as it is not declarative and is broken with newer postgresql versions. Consider using instead or a tool that is more suited for managing the data inside a postgresql database. -
idris2was updated to v0.7.0. This version introduces breaking changes. Check out the changelog for details. -
hvmwas updated to version 2. -
nvtopfamily of packages was reorganized into nested attrset.nvtophas been renamed tonvtopPackages.full, and allnvtop-{amd,nvidia,intel,msm}packages are now named asnvtopPackages.{amd,nvidia,intel,msm}. -
neo4jhas been updated to version 5. You may want to read the release notes for Neo4j 5. -
services.neo4j.allowUpgradewas removed and no longer has any effect. Neo4j 5 supports automatic rolling upgrades. -
unifiLTS,unifi5andunifi6have been removed, as they require MongoDB versions which are end-of-life. All these versions can be upgraded tounifi7directly. -
mongodb-4_4has been removed as it has reached end of life. Consequently,unifi7andunifi8now use MongoDB 5.0 by default. -
mongodb-5_0and newer requires a cpu with the avx instruction set to run. -
nitterrequires aguest_accounts.jsonlto 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. -
boot.supportedFilesystemsandboot.initrd.supportedFilesystemsare 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 usingsupportedFilesystems.fs or falseinstead of usinglib.elem "fs" supportedFilesystemsas was done previously. -
services.aria2.rpcSecrethas been replaced withservices.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"becomesservices.aria2.rpcSecretFile = "/path/to/secret_file"where the filesecret_filecontains the stringmysecret. -
The
system.forbiddenDependenciesRegexoption has been renamed tosystem.forbiddenDependenciesRegexesand now has the type oflistOf stringinstead ofstringto accept multiple regexes. -
openssh,openssh_hpnandopenssh_gssapiare 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 usingoverrideto setdsaKeysSupport = true. -
buildGoModulenow throws an error whenvendorHashis not specified.vendorSha256, deprecated in Nixpkgs 23.11, is now ignored and is no longer avendorHashalias. -
services.invidious.settings.db.user, the default database username has changed fromkemaltoinvidious. Setups involving an externally-provisioned database (i.e.services.invidious.database.createLocally == false) should adjust their configuration accordingly. The oldkemaluser will not be removed automatically even when the database is provisioned automatically.(https://github.com/NixOS/nixpkgs/pull/265857). -
writeReferencesToFileis deprecated in favour of the new trivial build helperwriteClosure. The latter accepts a list of paths and has an unambiguous name and cleaner implementation. -
inetutilsnow has a lower priority to avoid shadowing the commonly usedutil-linux. If one wishes to restore the default priority, simply uselib.setPrio 5 inetutilsor override withmeta.priority = 5. -
paperless'services.paperless.extraConfigsetting has been removed and converted to the free-form type and option namedservices.paperless.settings. -
davfs2'services.davfs2.extraConfigsetting has been deprecated and converted to the free-form type option namedservices.davfs2.settingsaccording to RFC42. -
services.homepage-dashboardnow takes its configuration using native Nix expressions, rather than dumping templated configurations into/var/lib/homepage-dashboardwhere 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. -
haremay now be cross-compiled. For that to work, however,haredocneeded to stop being built together with it. Thus, the latter is now its own package with the name ofharedoc. -
network-interfaces.targetsystem target was removed as it has been deprecated for a long time. Usenetwork.targetinstead. -
services.redis.vmOverCommitnow defaults totrueand no longer enforces Transparent Hugepages (THP) to be disabled. Redis only works with THP configured tomadvisewhich is the kernel's default. -
azure-clinow has extension support. For example, to install theaks-previewextension, useenvironment.systemPackages = [ (azure-cli.withExtensions [ azure-cli.extensions.aks-preview ]) ];To make the
azure-cliimmutable and prevent clashes in caseazure-cliis also installed via other package managers, some configuration files were moved into the derivation. This can be disabled by overridingwithImmutableConfig = falsewhen buildingazure-cli. -
services.frp.settingsnow 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.- The
settings.commonsection in the configuration is no longer valid and all the options form inside it now goes directly undersettings. - The
_separating words in the configuration options is removed so the options are now in camel case. For example:server_addrbecomesserverAddr,server_portbecomesserverPortetc. - Proxies are now defined with a new option
settings.proxieswhich takes a list of proxies. - Consult the upstream documentation for more details on the changes.
- The
-
mkosiwas 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. -
gonichas been updated to v0.16.4. Config now requiresplaylists-pathto be set. See the rest of the v0.16.0 release notes for more details. -
services.vikunjasystemd service now usesvikunjaas dynamic user instead ofvikunja-api. Database users might need to be changed. -
services.vikunja.setupNginxsetting has been removed. Users now need to setup the webserver configuration on their own with a proxy pass to the vikunja service. -
services.vmagentmodule deprecatesdataDir,groupandusersetting in favor of systemd provided CacheDirectory and DynamicUser. -
services.vmagent.remoteWriteUrlsetting has been renamed toservices.vmagent.remoteWrite.urland now defaults tonull. -
woodpecker-*packages have been updated to v2 which includes breaking changes. -
services.nginxwill 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'; ''; } -
optparse-bashis now dropped due to upstream inactivity. Alternatives available in Nixpkgs includeargc,argbash,bashlyandgum, to name a few. -
kanatapackage 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. -
craftos-pcpackage has been updated to v2.8, which includes breaking changes.- Files are now handled in binary mode; this could break programs with embedded UTF-8 characters.
- The ROM was updated to match ComputerCraft version v1.109.2.
- The bundled Lua was updated to Lua v5.2, which includes breaking changes. See the Lua manual for more information.
- The WebSocket API was rewritten, which introduced breaking changes.
-
gtestpackage has been updated past v1.13.0, which requires C++14 or higher. -
Nextcloud 26 has been removed since it's not maintained anymore by upstream.
-
The latest available version of Nextcloud is v29 (available as
pkgs.nextcloud29). The installation logic is as follows:- If
services.nextcloud.packageis specified explicitly, this package will be installed (recommended) - If
system.stateVersionis >=24.05,pkgs.nextcloud29will be installed by default. - If
system.stateVersionis >=23.11,pkgs.nextcloud27will be installed by default. - Please note that an upgrade from v27 (or older) to v29 directly is not possible. Please upgrade to
nextcloud28(or earlier) first. Nextcloud prohibits skipping major versions while upgrading. You can upgrade by declaringservices.nextcloud.package = pkgs.nextcloud28;. - Known warnings after the upgrade are documented in from now on.
- The "Photos" app only displays Media from inside the
Photosdirectory. This can be changed manually in the "Photos" tab below "Photos settings".
- If
-
The vendored third party libraries have been mostly removed from
cudaPackages.nsight_systems, which we now only ship forcudaPackages_11_8and later due to outdated dependencies. Users comfortable with the vendored dependencies may useoverrideAttrsto amend thepostPatchphase and themeta.brokencorrespondingly. Alternatively, one could package the deprecatedboost170locally, as required forcudaPackages_11_4.nsight_systems. -
cudaPackagespackage scope has been updated tocudaPackages_12. -
The deprecated
cudaPackages.cudatoolkithas been replaced with a symlink-based wrapper for the splayed redistributable CUDA packages. The wrapper only includes tools and libraries necessary to build common packages like e.g. tensorflow. The original runfile-basedcudatoolkitis still available ascudatoolkit-legacy-runfile. -
halloypackage was updated past 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. -
If
services.smokeping.webServicewas enabled, smokeping is now served via nginx instead of thttpd. This change brings the following consequences:- The default port for smokeping is now the nginx default port 80 instead of 8081.
- The option
services.smokeping.porthas been removed. To customize the port, useservices.nginx.virtualHosts.smokeping.listen.*.port.
-
The
wpaperdpackage has a breaking change moving to 1.0.1, 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) toconfig.toml. -
Ada packages (libraries and tools) have been moved into the
gnatPackagesscope.gnatPackagesuses the default GNAT compiler,gnat12Packagesandgnat13Packagesuse the respective matching compiler version. -
Paths provided as
restartTriggersandreloadTriggersfor 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 ofconfig.txtchanged. -
spark2014has been renamed tognatprove. A version ofgnatprovematching different GNAT versions is available from the differentgnatPackagessets. -
services.resolved.fallbackDnscan now be used to disable the upstream fallback servers entirely by setting it to an empty list. To get the previous behaviour of the upstream defaults set it to null, the new default, instead. -
services.hledger-web.capabilitiesoptions has been replaced by a new optionservices.hledger-web.allow.allow = "view"meanscapabilities = { view = true; };allow = "add"meanscapabilities = { view = true; add = true; };allow = "edit"meanscapabilities = { view = true; add = true; edit = true };allow = "sandstorm"reads permissions from theX-Sandstorm-Permissionsrequest header.
-
xxdhas been moved fromvimdefault output to its own output to reduce closure size. The canonical way to reference it across all platforms isunixtools.xxd. -
stalwart-mailpackage has been updated to v0.5.3, which includes breaking changes. -
services.zope2has been removed aszope2is unmaintained and was relying on Python2. -
services.oauth2_proxywas renamed toservices.oauth2-proxy. Also the corresponding service, user and group were renamed. -
services.avahi.nssmdnsgot split intoservices.avahi.nssmdns4andservices.avahi.nssmdns6which enable the mDNS NSS switch 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. -
A warning has been added for services that are
after = [ "network-online.target" ]but do not depend on it (e.g. usingwants), because the dependency thatmulti-user.targethas onnetwork-online.targetis planned for removal. -
services.pgbouncernow has systemd support enabled and will log to journald. The default setting forservices.pgbouncer.logFileis nownullto disable logging to a separate log file. -
services.archisteamfarmno longer uses the abbreviationasffor its state directory (/var/lib/asf), user and group (bothasf). Instead the long namearchisteamfarmis used. Configurations withsystem.stateVersion23.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. -
xfsprogswas 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 withmkfs.xfs -i nrext64=0, if they need to be readable by GRUB2 before 2.12 or kernels older than 5.19. -
networking.iproute2.enablenow does not setenvironment.etc."iproute2/rt_tables".text.Setting
environment.etc."iproute2/{CONFIG_FILE_NAME}".textwill override the whole configuration file instead of appending it to the upstream configuration file.CONFIG_FILE_NAMEincludesbpf_pinning,ematch_map,group,nl_protos,rt_dsfield,rt_protos,rt_realms,rt_scopes, andrt_tables. -
netboxwas updated to v3.7.services.netbox.packagestill defaults to v3.6 ifstateVersionis earlier than 24.05. Refer to upstream's breaking changes for v3.7.0 and upgrade NetBox by changingservices.netbox.package. Database migrations will be run automatically. -
gaugenow supports installing plugins using nix. For the old imperative approach, switch togauge-unwrapped. You can load plugins from an existing gauge manifest file usinggauge.fromManifest ./path/to/manifest.jsonor specify plugins in nix usinggauge.withPlugins (p: with p; [ js html-report xml-report ]). -
firefox-devedition,firefox-beta,firefox-esrexecutable file names for now match their package names, which is consistent with thefirefox-*-binpackages. The desktop entries are also updated so that you can have multiple editions of firefox in your app launcher. -
chromiumandungoogled-chromiumhad a long standing issue regarding Widevine DRM handling in nixpkgs fixed.chromiumnow no longer automatically downloads Widevine when encountering DRM protected content. To be able to play DRM protected content inchromiumnow, you have to explicitly opt-in as originally intended usingchromium.override { enableWideVine = true; }. This override has been added almost 10 years ago. -
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.
-
systemd.oomdmodule behavior is changed as:-
Raise ManagedOOMMemoryPressureLimit from 50% to 80%. This should make systemd-oomd kill things less often, and fix issues like this. Reference: commit.
-
Remove swap policy. This helps prevent killing processes when user's swap is small.
-
Expand the memory pressure policy to system.slice, user-.slice, and all user owned slices. Reference: commit.
-
systemd.oomd.enableUserServicesis renamed tosystemd.oomd.enableUserSlices.
-
-
security.pam.enableSSHAgentAuthnow requiresservices.openssh.authorizedKeysFilesto be non-empty, which is the case whenservices.openssh.enableis true. Previously,pam_ssh_agent_authsilently failed to work. -
The configuration format for
services.prometheus.exporters.snmpchanged 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. -
watchdogd, a system and process supervisor using watchdog timers. Available as services.watchdogd.
-
jdt-language-serverpackage now uses upstream's provided python wrapper instead of our own custom wrapper. This results in the following breaking and notable changes:-
The main binary for the package is now named
jdtlsinstead ofjdt-language-server, equivalent to what most editors expect the binary to be named. -
JVM arguments should now be provided with the
--jvm-argflag instead of settingJAVA_OPTS. -
The
-datapath is no longer required to run the package, and will be set to point to a folder in$TMPif missing.
-
-
nomadhas 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.-
nomadis now Nomad 1.7.x. -
nomad_1_4has been removed, as it is now unsupported upstream.
-
-
Dwarf Fortress has been updated to version 50, and its derivations continue to menace with spikes of Nix and bash. Version 50 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.
-
Running an earlier version can be achieved through an override:
dwarf-fortress-packages.dwarf-fortress-full.override { dfVersion = "0.47.5"; } -
Ruby plugin support has been disabled in DFHack. Many of the Ruby plugins have been converted to Lua, and support was removed upstream due to frequent crashes.
-
-
livebookpackage is now built as amix releaseinstead of anescript. This means that configuration now has to be done using environment variables instead of command line arguments. This has the further implication that thelivebookservice configuration has changed: -
erlang_node_short_name,erlang_node_name,portandoptionsconfiguration parameters are gone, and have been replaced with anenvironmentparameter. Use the appropriate environment variables insideenvironmentto configure the service instead. -
akkomanow 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. -
crystalpackage has been updated to 1.11.x, which has some breaking changes. Refer to crystal's changelog for more information. (v1.10, v1.11) -
erlang-lspackage no longer ships theels_dapbinary as of v0.51.0. -
icuno longer includesinstall-shandmkinstalldirsin the shared folder. -
The
go-ethereumpackage 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.
Other Notable Changes
-
addDriverRunpathhas been added to facilitate the deprecation of the oldaddOpenGLRunpathsetuphook. This change is motivated by the evolution of the setuphook to include all hardware acceleration. -
cinnamonhas been updated to 6.0. Please beware that the Wayland session is still experimental in this release and could potentially affect Xorg sessions. We suggest a reboot when switching between sessions. -
matehas been updated to 1.28.- To properly support panel plugins built with Wayland (in-process) support, we are introducing
services.xserver.desktopManager.mate.extraPanelAppletsoption, please use that for installing panel applets. - Similarly, please use
services.xserver.desktopManager.mate.extraCajaExtensionsoption for installing Caja extensions. - To use the Wayland session, enable
services.xserver.desktopManager.mate.enableWaylandSession. This is opt-in for now as it is in early stage and introduces a new set of Wayfire closure. Due to known issues with LightDM, we suggest using SDDM for display manager.
- To properly support panel plugins built with Wayland (in-process) support, we are introducing
-
services.xserver.desktopManager.budgieinstallsgnome.gnome-terminalby default (instead ofmate.mate-terminal). -
New
boot.loader.systemd-boot.xbootldrMountPointallows 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-bootwill now verify thatefiSysMountPoint(andxbootldrMountPointif configured) are mounted partitions. -
services.postgresql.extraPluginschanged its type from just a list of packages to also a function that returns such a list. For example a config line likeservices.postgresql.extraPlugins = with pkgs.postgresql_11.pkgs; [ postgis ];is recommended to be changed toservices.postgresql.extraPlugins = ps: with ps; [ postgis ];; -
services.opensshnow has an optionauthorizedKeysInHomedir, controlling whether~/.ssh/authorizedKeysis added toauthorizedKeysFiles. ::: {.note} This option currently defaults totruefor NixOS 24.05, preserving the previous behaviour. This is expected to change in NixOS 24.11. ::: ::: {.warning} Users should check that their SSH keys are inusers.users.*.openssh, or that they have another way to access and administer the system, before setting this option tofalse. ::: -
matrix-synapsehomeserver module now supports configuring UNIX domain socketlistenersthrough thepathoption. The default replication worker on the main instance has been migrated away from TCP sockets to UNIX domain sockets. -
boot.initrd.network.ssh.authorizedKeyFilesis a new option in the initrd ssh daemon module, for adding authorized keys via list of files. -
appimage,appimageTools.wrapAppImageandbuildFHSEnvBubblewrapnow properly acceptspnameandversion. -
Programs written in Nim are built with libraries selected by lockfiles. The
nimPackagesandnim2Packagessets have been removed. See https://nixos.org/manual/nixpkgs/unstable#nim for more information. -
buildDubPackagecan now be used to build Programs written in D using thedubbuild system and package manager. See the D section in the manual for more information. -
stalwart-mailservice uses the legacy version 0.6.X as default because newerstalwart-mailversions require a manual upgrade process. Changeservices.stalwart-mail.packagetopkgs.stalwart-mailif you wish to switch to the new version. -
portunushas 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. -
A stdenv's default set of hardening flags can now be set via its
bintools-wrapper'sdefaultHardeningFlagsargument. A convenient stdenv adapter,withDefaultHardeningFlags, can be used to override an existing stdenv'sdefaultHardeningFlags. -
libassnow uses the native CoreText backend on Darwin, which may fix subtitle rendering issues withmpv,ffmpeg, etc. -
garagehas been updated to v1.x.x. Users should read the upstream release notes and follow the documentation when changing over theirservices.garage.packageand performing this manual upgrade. -
The EC2 image module now enables the Amazon SSM Agent by default.
-
The following options of the Nextcloud module were moved into
services.nextcloud.settingsand renamed to match the name from Nextcloud'sconfig.php:logLevel->loglevel,logType->log_type,defaultPhoneRegion->default_phone_region,overwriteProtocol->overwriteprotocol,skeletonDirectory->skeletondirectory,globalProfiles->profile.enabled,extraTrustedDomains->trusted_domainsandtrustedProxies->trusted_proxies.
-
services.nextcloud.config.dbportoption of the Nextcloud module was removed to match upstream. The port can be specified inservices.nextcloud.config.dbhost. -
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.
-
systemdunits can now specify theUpholds=andUpheldBy=unit dependencies via the aptly namedupholdsandupheldByoptions. These options get systemd to enforce that the dependencies remain continuosly running for as long as the dependent unit is in a running state. -
stdenv: The--replaceflag insubstitute,substituteInPlace,substituteAll,substituteAllStream, andsubstituteStreamis now deprecated if favor of the new--replace-fail,--replace-warnand--replace-quiet. The deprecated--replaceequates to--replace-warn. -
A new hardening flag,
zerocallusedregswas made available, corresponding to the gcc/clang option-fzero-call-used-regs=used-gpr. -
A new hardening flag,
trivialautovarinitwas made available, corresponding to the gcc/clang option-ftrivial-auto-var-init=pattern. -
New options were added to the dnsdist module to enable and configure a DNSCrypt endpoint (see
services.dnsdist.dnscrypt.enable, etc.). The module can generate the DNSCrypt provider key pair, certificates and also performs their rotation automatically with no downtime. -
sonarrversion 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. -
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. -
netbirdmodule now allows running multiple tunnels in parallel throughservices.netbird.tunnels. -
Nginx virtual hosts using
forceSSLorglobalRedirectcan now have redirect codes other than 301 throughredirectCode. -
baculanow allows to configureTLSfor encrypted communication. -
libjxlversion bumped from 0.8.2 to 0.9.1 dropped support for the butteraugli API. You will no longer be able to setenableButterauglionlibaom. -
mockgenpackage source has changed to the go.uber.org/mock fork because the original repository is no longer maintained. -
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 since 22.11.
-
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). -
services.zfs.zed.enableMailnow uses the globalsendmailwrapper defined by an email module (such as msmtp or Postfix). It no longer requires using a special ZFS build with email support. -
castopodhas 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 informations. -
nextcloud-setup.serviceno longer changes the group of each file & 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. -
services.kavitanow uses the free-form optionservices.kavita.settingsfor the application settings file. The optionsservices.kavita.ipAdressesandservices.kavita.portnow exist atservices.kavita.settings.IpAddressesandservices.kavita.settings.IpAddresses. The file atservices.kavita.tokenKeyFilenow needs to contain a secret with 512+ bits instead of 128+ bits. -
kavitahas 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. -
krb5module has been rewritten and moved tosecurity.krb5, moving all options butsecurity.krb5.enableandsecurity.krb5.packageintosecurity.krb5.settings. -
services.sojunow has a wrapper for thesojuctlcommand, pointed at the service config file. It also has the new optionadminSocket.enable, which creates a unix admin socket at/run/soju/admin. -
giteaupgrade to 1.21 has several breaking changes, including:- Custom themes and other assets that were previously stored in
custom/public/*now belong incustom/public/assets/* - New instances of Gitea using MySQL now ignore the
[database].CHARSETconfig option and always use theutf8mb4charset, existing instances should migrate via thegitea doctor convertCLI command.
- Custom themes and other assets that were previously stored in
-
services.paperlessmodule no longer uses the previously downloaded NLTK data stored in/var/cache/paperless/nltk. This directory can be removed. -
services.teeworldsmodule now has a wealth of configuration options, including a newpackageoption. -
hardware.pulseaudiomodule now sets permission of pulse user home directory to 755 when running in "systemWide" mode. It fixes issue 114399. -
services.networkmanager.extraConfigwas renamed toservices.networkmanager.settingsand was changed to use the ini type instead of using a multiline string. -
services.github-runnermodule has been removed. To configure a single GitHub Actions Runner refer toservices.github-runners.*. Note that this will trigger a new runner registration. -
services.slskdhas been refactored to include more configuation options in the free-formservices.slskd.settingsoption, 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 thevhost-optionstype. -
services.btrbknow automatically selects and provides required compression program depending on the configuredstream_compressoption. Since this replaces the need for theextraPackagesoption, this option will be deprecated in future releases. -
mpichpackage expression now requireswithPmto be a list, e.g."hydra:gforker"becomes[ "hydra" "gforker" ]. -
systemd: when merging unit options (of typeunitOption), 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 tomkForce, hence to retain the definitions not anticipating that need. -
Lisp modules: previously deprecated interface based on
common-lisp.shhas now been removed. -
youtrackis bumped to 2023.3. The update is not performed automatically, it requires manual interaction. See the YouTrack section in the manual for details. -
qt6.qtmultimediahas changed its default backend toQT_MEDIA_BACKEND=ffmpeg(previouslygstreameron Linux ordarwinon MacOS). The previous native backends remain available but are now minimally maintained. Refer to upstream documentation for further details about each platform. -
drbdout-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. -
oils-for-unix, the oil shell's c++ version is now available. The python version is still available asoil. -
documentation.man.mandocnow by default usesMANPATHto 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 themandoc.confconfiguration file like before, usedocumentation.man.mandoc.settings.manpathinstead. -
The
systemd-confinementmodule extension is now compatible withDynamicUser=trueand thusProtectSystem=stricttoo. -
grafana-lokipackage was updated to 3.0.0 which includes breaking changes. -
programs.fish.packagenow allows you to override the package used in thefishmodule.