path: root/nixos/doc/manual/from_md/release-notes/rl-2211.section.xml

<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-release-22.11">
  <title>Release 22.11 (“Raccoon”, 2022.11/??)</title>
  <para>
    Support is planned until the end of June 2023, handing over to
    23.05.
  </para>
  <section xml:id="sec-release-22.11-highlights">
    <title>Highlights</title>
    <para>
      In addition to numerous new and upgraded packages, this release
      has the following highlights:
    </para>
    <itemizedlist>
      <listitem>
        <para>
          During cross-compilation, tests are now executed if the test
          suite can be executed by the build platform. This is the case
          when doing “native” cross-compilation where the build and host
          platforms are largely the same, but the nixpkgs’ cross
          compilation infrastructure is used, e.g.
          <literal>pkgsStatic</literal> and <literal>pkgsLLVM</literal>.
          Another possibility is that the build platform is a superset
          of the host platform, e.g. when cross-compiling from
          <literal>x86_64-unknown-linux</literal> to
          <literal>i686-unknown-linux</literal>. The predicate gating
          test suite execution is the newly added
          <literal>canExecute</literal> predicate: You can e.g. check if
          <literal>stdenv.buildPlatform</literal> can execute binaries
          built for <literal>stdenv.hostPlatform</literal> (i.e.
          produced by <literal>stdenv.cc</literal>) by evaluating
          <literal>stdenv.buildPlatform.canExecute stdenv.hostPlatform</literal>.
        </para>
      </listitem>
      <listitem>
        <para>
          The <literal>nixpkgs.hostPlatform</literal> and
          <literal>nixpkgs.buildPlatform</literal> options have been
          added. These cover and override the
          <literal>nixpkgs.{system,localSystem,crossSystem}</literal>
          options.
        </para>
        <itemizedlist spacing="compact">
          <listitem>
            <para>
              <literal>hostPlatform</literal> is the platform or
              <quote><literal>system</literal></quote> string of the
              NixOS system described by the configuration.
            </para>
          </listitem>
          <listitem>
            <para>
              <literal>buildPlatform</literal> is the platform that is
              responsible for building the NixOS configuration. It
              defaults to the <literal>hostPlatform</literal>, for a
              non-cross build configuration. To cross compile, set
              <literal>buildPlatform</literal> to a different value.
            </para>
          </listitem>
        </itemizedlist>
        <para>
          The new options convey the same information, but with fewer
          options, and following the Nixpkgs terminology.
        </para>
        <para>
          The existing options
          <literal>nixpkgs.{system,localSystem,crossSystem}</literal>
          have not been formally deprecated, to allow for evaluation of
          the change and to allow for a transition period so that in
          time the ecosystem can switch without breaking compatibility
          with any supported NixOS release.
        </para>
      </listitem>
      <listitem>
        <para>
          <literal>nixos-generate-config</literal> now generates
          configurations that can be built in pure mode. This is
          achieved by setting the new
          <literal>nixpkgs.hostPlatform</literal> option.
        </para>
        <para>
          You may have to unset the <literal>system</literal> parameter
          in <literal>lib.nixosSystem</literal>, or similarly remove
          definitions of the
          <literal>nixpkgs.{system,localSystem,crossSystem}</literal>
          options.
        </para>
        <para>
          Alternatively, you can remove the
          <literal>hostPlatform</literal> line and use NixOS like you
          would in NixOS 22.05 and earlier.
        </para>
      </listitem>
      <listitem>
        <para>
          PHP now defaults to PHP 8.1, updated from 8.0.
        </para>
      </listitem>
      <listitem>
        <para>
          Cinnamon has been updated to 5.4.
        </para>
      </listitem>
      <listitem>
        <para>
          <literal>hardware.nvidia</literal> has a new option
          <literal>open</literal> that can be used to opt in the
          opensource version of NVIDIA kernel driver. Note that the
          driver’s support for GeForce and Workstation GPUs is still
          alpha quality, see
          <link xlink:href="https://developer.nvidia.com/blog/nvidia-releases-open-source-gpu-kernel-modules/">NVIDIA
          Releases Open-Source GPU Kernel Modules</link> for the
          official announcement.
        </para>
      </listitem>
    </itemizedlist>
  </section>
  <section xml:id="sec-release-22.11-new-services">
    <title>New Services</title>
    <itemizedlist>
      <listitem>
        <para>
          <link xlink:href="https://github.com/jollheef/appvm">appvm</link>,
          Nix based app VMs. Available as
          <link xlink:href="options.html#opt-virtualisation.appvm.enable">virtualisation.appvm</link>.
        </para>
      </listitem>
      <listitem>
        <para>
          <link xlink:href="https://github.com/mozilla-services/syncstorage-rs">syncstorage-rs</link>,
          a self-hostable sync server for Firefox. Available as
          <link xlink:href="options.html#opt-services.firefox-syncserver.enable">services.firefox-syncserver</link>.
        </para>
      </listitem>
      <listitem>
        <para>
          <link xlink:href="https://dragonflydb.io/">dragonflydb</link>,
          a modern replacement for Redis and Memcached. Available as
          <link linkend="opt-services.dragonflydb.enable">services.dragonflydb</link>.
        </para>
      </listitem>
      <listitem>
        <para>
          <link xlink:href="https://hbase.apache.org/">HBase
          cluster</link>, a distributed, scalable, big data store.
          Available as
          <link xlink:href="options.html#opt-services.hadoop.hbase.enable">services.hadoop.hbase</link>.
        </para>
      </listitem>
      <listitem>
        <para>
          <link xlink:href="https://github.com/leetronics/infnoise">infnoise</link>,
          a hardware True Random Number Generator dongle. Available as
          <link xlink:href="options.html#opt-services.infnoise.enable">services.infnoise</link>.
        </para>
      </listitem>
      <listitem>
        <para>
          <link xlink:href="https://github.com/jtroo/kanata">kanata</link>,
          a tool to improve keyboard comfort and usability with advanced
          customization. Available as
          <link xlink:href="options.html#opt-services.kanata.enable">services.kanata</link>.
        </para>
      </listitem>
      <listitem>
        <para>
          <link xlink:href="https://github.com/aiberia/persistent-evdev">persistent-evdev</link>,
          a daemon to add virtual proxy devices that mirror a physical
          input device but persist even if the underlying hardware is
          hot-plugged. Available as
          <link linkend="opt-services.persistent-evdev.enable">services.persistent-evdev</link>.
        </para>
      </listitem>
      <listitem>
        <para>
          <link xlink:href="https://schleuder.org/">schleuder</link>, a
          mailing list manager with PGP support. Enable using
          <link linkend="opt-services.schleuder.enable">services.schleuder</link>.
        </para>
      </listitem>
      <listitem>
        <para>
          <link xlink:href="https://www.expressvpn.com">expressvpn</link>,
          the CLI client for ExpressVPN. Available as
          <link linkend="opt-services.expressvpn.enable">services.expressvpn</link>.
        </para>
      </listitem>
      <listitem>
        <para>
          <link xlink:href="https://www.grafana.com/oss/tempo/">Grafana
          Tempo</link>, a distributed tracing store. Available as
          <link linkend="opt-services.tempo.enable">services.tempo</link>.
        </para>
      </listitem>
    </itemizedlist>
  </section>
  <section xml:id="sec-release-22.11-incompatibilities">
    <title>Backward Incompatibilities</title>
    <itemizedlist>
      <listitem>
        <para>
          The <literal>isCompatible</literal> predicate checking CPU
          compatibility is no longer exposed by the platform sets
          generated using <literal>lib.systems.elaborate</literal>. In
          most cases you will want to use the new
          <literal>canExecute</literal> predicate instead which also
          considers the kernel / syscall interface. It is briefly
          described in the release’s
          <link linkend="sec-release-22.11-highlights">highlights
          section</link>.
          <literal>lib.systems.parse.isCompatible</literal> still
          exists, but has changed semantically: Architectures with
          differing endianness modes are <emphasis>no longer considered
          compatible</emphasis>.
        </para>
      </listitem>
      <listitem>
        <para>
          <literal>ngrok</literal> has been upgraded from 2.3.40 to
          3.0.4. Please see
          <link xlink:href="https://ngrok.com/docs/guides/upgrade-v2-v3">the
          upgrade guide</link> and
          <link xlink:href="https://ngrok.com/docs/ngrok-agent/changelog">changelog</link>.
          Notably, breaking changes are that the config file format has
          changed and support for single hypen arguments was dropped.
        </para>
      </listitem>
      <listitem>
        <para>
          <literal>i18n.supportedLocales</literal> is now by default
          only generated with the locales set in
          <literal>i18n.defaultLocale</literal> and
          <literal>i18n.extraLocaleSettings</literal>. This got
          partially copied over from the minimal profile and reduces the
          final system size by up to 200MB. If you require all locales
          installed set the option to
          <literal>[ &quot;all&quot; ]</literal>.
        </para>
      </listitem>
      <listitem>
        <pa