nixos/modules/rename.nix

   1 { lib, ... }:
   2
   3 let
   4   inherit (lib)
   5     mkAliasOptionModuleMD
   6     mkRemovedOptionModule;
   7 in
   8 {
   9   imports = [
  10     /*
  11     This file defines some renaming/removing options for backwards compatibility
  12
  13     It should ONLY be used when the relevant module can't define these imports
  14     itself, such as when the module was removed completely.
  15     See https://github.com/NixOS/nixpkgs/pull/61570 for explanation
  16     */
  17
  18     # This alias module can't be where _module.check is defined because it would
  19     # be added to submodules as well there
  20     (mkAliasOptionModuleMD [ "environment" "checkConfigurationOptions" ] [ "_module" "check" ])
  21
  22     # Completely removed modules
  23     (mkRemovedOptionModule [ "boot" "loader" "raspberryPi" ] "The raspberryPi boot loader has been removed. See https://github.com/NixOS/nixpkgs/pull/241534 for what to use instead.")
  24     (mkRemovedOptionModule [ "environment" "blcr" "enable" ] "The BLCR module has been removed")
  25     (mkRemovedOptionModule [ "environment" "noXlibs" ] ''
  26       The environment.noXlibs option was removed, as it often caused surprising breakages for new users.
  27       If you need its functionality, you can apply similar overlays in your own config.
  28     '')
  29     (mkRemovedOptionModule [ "fonts" "fontconfig" "penultimate" ] "The corresponding package has removed from nixpkgs.")
  30     (mkRemovedOptionModule [ "hardware" "brightnessctl" ] ''
  31       The brightnessctl module was removed because newer versions of
  32       brightnessctl don't require the udev rules anymore (they can use the
  33       systemd-logind API). Instead of using the module you can now
  34       simply add the brightnessctl package to environment.systemPackages.
  35     '')
  36     (mkRemovedOptionModule [ "hardware" "u2f" ] ''
  37       The U2F modules module was removed, as all it did was adding the
  38       udev rules from libu2f-host to the system. Udev gained native support
  39       to handle FIDO security tokens, so this isn't necessary anymore.
  40     '')
  41     (mkRemovedOptionModule [ "hardware" "xow" ] ''
  42       The xow package was removed from nixpkgs. Upstream has deprecated
  43       the project and users are urged to switch to xone.
  44     '')
  45     (mkRemovedOptionModule [ "networking" "vpnc" ] "Use environment.etc.\"vpnc/service.conf\" instead.")
  46     (mkRemovedOptionModule [ "networking" "wicd" ] "The corresponding package was removed from nixpkgs.")
  47     (mkRemovedOptionModule [ "programs" "gnome-documents" ] "The corresponding package was removed from nixpkgs.")
  48     (mkRemovedOptionModule [ "programs" "pantheon-tweaks" ] ''
  49       pantheon-tweaks is no longer a switchboard plugin but an independent app,
  50       adding the package to environment.systemPackages is sufficient.
  51     '')
  52     (mkRemovedOptionModule [ "programs" "tilp2" ] "The corresponding package was removed from nixpkgs.")
  53     (mkRemovedOptionModule [ "programs" "way-cooler" ] ("way-cooler is abandoned by its author: " +
  54       "https://way-cooler.org/blog/2020/01/09/way-cooler-post-mortem.html"))
  55     (mkRemovedOptionModule [ "security" "hideProcessInformation" ] ''
  56       The hidepid module was removed, since the underlying machinery
  57       is broken when using cgroups-v2.
  58     '')
  59     (mkRemovedOptionModule [ "services" "antennas" ] "The antennas package and the corresponding module have been removed as they only work with tvheadend, which nobody was willing to maintain and was stuck on an unmaintained version that required FFmpeg 4; please see https://github.com/NixOS/nixpkgs/pull/332259 if you are interested in maintaining a newer version.")
  60     (mkRemovedOptionModule [ "services" "ankisyncd" ] "`services.ankisyncd` has been replaced by `services.anki-sync-server`.")
  61     (mkRemovedOptionModule [ "services" "baget" "enable" ] "The baget module was removed due to the upstream package being unmaintained.")
  62     (mkRemovedOptionModule [ "services" "beegfs" ] "The BeeGFS module has been removed")
  63     (mkRemovedOptionModule [ "services" "beegfsEnable" ] "The BeeGFS module has been removed")
  64     (mkRemovedOptionModule [ "services" "cgmanager" "enable"] "cgmanager was deprecated by lxc and therefore removed from nixpkgs.")
  65     (mkRemovedOptionModule [ "services" "chronos" ] "The corresponding package was removed from nixpkgs.")
  66     (mkRemovedOptionModule [ "services" "confluence" ] "Atlassian software has 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")
  67     (mkRemovedOptionModule [ "services" "couchpotato" ] "The corresponding package was removed from nixpkgs.")
  68     (mkRemovedOptionModule [ "services" "crowd" ] "Atlassian software has 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")
  69     (mkRemovedOptionModule [ "services" "dd-agent" ] "dd-agent was removed from nixpkgs in favor of the newer datadog-agent.")
  70     (mkRemovedOptionModule [ "services" "dnscrypt-proxy" ] "Use services.dnscrypt-proxy2 instead")
  71     (mkRemovedOptionModule [ "services" "dnscrypt-wrapper" ] ''
  72       The dnscrypt-wrapper module was removed since the project has been effectively unmaintained since 2018;
  73       moreover the NixOS module had to rely on an abandoned version of dnscrypt-proxy v1 for the rotation of keys.
  74
  75       To wrap a resolver with DNSCrypt you can instead use dnsdist. See options `services.dnsdist.dnscrypt.*`
  76     '')
  77     (mkRemovedOptionModule [ "services" "exhibitor" ] "The corresponding package was removed from nixpkgs.")
  78     (mkRemovedOptionModule [ "services" "firefox" "syncserver" ] "The corresponding package was removed from nixpkgs.")
  79     (mkRemovedOptionModule [ "services" "flashpolicyd" ] "The flashpolicyd module has been removed. Adobe Flash Player is deprecated.")
  80     (mkRemovedOptionModule [ "services" "fourStore" ] "The fourStore module has been removed")
  81     (mkRemovedOptionModule [ "services" "fourStoreEndpoint" ] "The fourStoreEndpoint module has been removed")
  82     (mkRemovedOptionModule [ "services" "fprot" ] "The corresponding package was removed from nixpkgs.")
  83     (mkRemovedOptionModule [ "services" "frab" ] "The frab module has been removed")
  84     (mkRemovedOptionModule [ "services" "homeassistant-satellite"] "The `services.homeassistant-satellite` module has been replaced by `services.wyoming-satellite`.")
  85     (mkRemovedOptionModule [ "services" "hydron" ] "The `services.hydron` module has been removed as the project has been archived upstream since 2022 and is affected by a severe remote code execution vulnerability.")
  86     (mkRemovedOptionModule [ "services" "ihatemoney" ] "The ihatemoney module has been removed for lack of downstream maintainer")
  87     (mkRemovedOptionModule [ "services" "jira" ] "Atlassian software has 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")
  88     (mkRemovedOptionModule [ "services" "kippo" ] "The corresponding package was removed from nixpkgs.")
  89     (mkRemovedOptionModule [ "services" "lshd" ] "The corresponding package was removed from nixpkgs as it had no maintainer in Nixpkgs and hasn't seen an upstream release in over a decades.")
  90     (mkRemovedOptionModule [ "services" "mailpile" ] "The corresponding package was removed from nixpkgs.")
  91     (mkRemovedOptionModule [ "services" "marathon" ] "The corresponding package was removed from nixpkgs.")
  92     (mkRemovedOptionModule [ "services" "mathics" ] "The Mathics module has been removed")
  93     (mkRemovedOptionModule [ "services" "matrix-sliding-sync" ] "The matrix-sliding-sync package has been removed, since matrix-synapse incorporated its functionality. Remove `services.sliding-sync` from your NixOS Configuration, and the `.well-known` record for `org.matrix.msc3575.proxy` from your webserver")
  94     (mkRemovedOptionModule [ "services" "meguca" ] "Use meguca has been removed from nixpkgs")
  95     (mkRemovedOptionModule [ "services" "mesos" ] "The corresponding package was removed from nixpkgs.")
  96     (mkRemovedOptionModule [ "services" "mxisd" ] "The mxisd module has been removed as both mxisd and ma1sd got removed.")
  97     (mkRemovedOptionModule [ "services" "moinmoin" ] "The corresponding package was removed from nixpkgs.")
  98     (mkRemovedOptionModule [ "services" "mwlib" ] "The corresponding package was removed from nixpkgs.")
  99     (mkRemovedOptionModule [ "services" "pantheon" "files" ] ''
 100       This module was removed, please add pkgs.pantheon.elementary-files to environment.systemPackages directly.
 101     '')
 102     (mkRemovedOptionModule [ "services" "prey" ] ''
 103       prey-bash-client is deprecated upstream
 104     '')
 105     (mkRemovedOptionModule [ "services" "quagga" ] "the corresponding package has been removed from nixpkgs")
 106     (mkRemovedOptionModule [ "services" "railcar" ] "the corresponding package has been removed from nixpkgs")
 107     (mkRemovedOptionModule [ "services" "replay-sorcery" ] "the corresponding package has been removed from nixpkgs as it is unmaintained upstream. Consider using `gpu-screen-recorder` or `obs-studio` instead.")
 108     (mkRemovedOptionModule [ "services" "seeks" ] "")
 109     (mkRemovedOptionModule [ "services" "shout" ] "shout was removed because it was deprecated upstream in favor of thelounge.")
 110     (mkRemovedOptionModule [ "services" "ssmtp" ] ''
 111       The ssmtp package and the corresponding module have been removed due to
 112       the program being unmaintained. The options `programs.msmtp.*` can be
 113       used instead.
 114     '')
 115     (mkRemovedOptionModule [ "services" "tvheadend" ] "The tvheadend package and the corresponding module have been removed as nobody was willing to maintain them and they were stuck on an unmaintained version that required FFmpeg 4; please see https://github.com/NixOS/nixpkgs/pull/332259 if you are interested in maintaining a newer version.")
 116     (mkRemovedOptionModule [ "services" "unifi-video" ] "The unifi-video package and the corresponding module have been removed as the software has been unsupported since 2021 and requires a MongoDB version that has reached end of life.")
 117     (mkRemovedOptionModule [ "services" "venus" ] "The corresponding package was removed from nixpkgs.")
 118     (mkRemovedOptionModule [ "services" "wakeonlan"] "This module was removed in favor of enabling it with networking.interfaces.<name>.wakeOnLan")
 119     (mkRemovedOptionModule [ "services" "winstone" ] "The corresponding package was removed from nixpkgs.")
 120     (mkRemovedOptionModule [ "services" "xserver" "displayManager" "auto" ] ''
 121       The services.xserver.displayManager.auto module has been removed
 122       because it was only intended for use in internal NixOS tests, and gave the
 123       false impression of it being a special display manager when it's actually
 124       LightDM. Please use the services.displayManager.autoLogin options
 125       instead, or any other display manager in NixOS as they all support auto-login.
 126     '')
 127     (mkRemovedOptionModule [ "services" "xserver" "multitouch" ] ''
 128       services.xserver.multitouch (which uses xf86_input_mtrack) has been removed
 129       as the underlying package isn't being maintained. Working alternatives are
 130       libinput and synaptics.
 131     '')
 132     (mkRemovedOptionModule [ "services" "xmr-stak" ] "The corresponding package was removed from nixpkgs.")
 133     (mkRemovedOptionModule [ "virtualisation" "rkt" ] "The rkt module has been removed, it was archived by upstream")
 134     (mkRemovedOptionModule [ "services" "racoon" ] ''
 135       The racoon module has been removed, because the software project was abandoned upstream.
 136     '')
 137     (mkRemovedOptionModule [ "services" "shellinabox" ] "The corresponding package was removed from nixpkgs.")
 138     (mkRemovedOptionModule [ "services" "gogoclient" ] "The corresponding package was removed from nixpkgs.")
 139     (mkRemovedOptionModule [ "services" "virtuoso" ] "The corresponding package was removed from nixpkgs.")
 140     (mkRemovedOptionModule [ "services" "openfire" ] "The corresponding package was removed from nixpkgs.")
 141     (mkRemovedOptionModule [ "services" "riak" ] "The corresponding package was removed from nixpkgs.")
 142     (mkRemovedOptionModule [ "services" "rtsp-simple-server" ] "Package has been completely rebranded by upstream as mediamtx, and thus the service and the package were renamed in NixOS as well.")
 143     (mkRemovedOptionModule [ "services" "prayer" ] "The corresponding package was removed from nixpkgs.")
 144     (mkRemovedOptionModule [ "services" "restya-board" ] "The corresponding package was removed from nixpkgs.")
 145
 146     (mkRemovedOptionModule [ "i18n" "inputMethod" "fcitx" ] "The fcitx module has been removed. Please use fcitx5 instead")
 147     (mkRemovedOptionModule [ "services" "dhcpd4" ] ''
 148       The dhcpd4 module has been removed because ISC DHCP reached its end of life.
 149       See https://www.isc.org/blogs/isc-dhcp-eol/ for details.
 150       Please switch to a different implementation like kea or dnsmasq.
 151     '')
 152     (mkRemovedOptionModule [ "services" "dhcpd6" ] ''
 153       The dhcpd6 module has been removed because ISC DHCP reached its end of life.
 154       See https://www.isc.org/blogs/isc-dhcp-eol/ for details.
 155       Please switch to a different implementation like kea or dnsmasq.
 156     '')
 157     (mkRemovedOptionModule [ "services" "tedicross" ] ''
 158       The corresponding package was broken and removed from nixpkgs.
 159     '')
 160
 161     # Do NOT add any option renames here, see top of the file
 162   ];
 163 }