                            Mageia 10 Release Notes

   Other languages
   Deutsch ; English ; Español

                            this page is a draft.

   It requires improvements. If you want to improve it, simply log in and
                           click on the Edit tab.

     Please remove this {{Draft}}template, when you're sure the page is
                            complete and correct.

     View the other draft pages, or other pages to improve and maintain.

   Warning!
   This page is a draft for the upcoming release Mageia 10. For
   pre-release testing see Official pre-release testing.
   Synopsis:
   Presentation of the evolution, new features, known issues, and the
   recent changes of the Mageia distribution.

Contents

     * 1 Introduction
          + 1.1 Available installation media
          + 1.2 The Mageia repositories
               o 1.2.1 32-bit repositories on 64-bit systems
     * 2 Release highlights
          + 2.1 32 Bit Support
     * 3 Major developments
          + 3.1 Installation
               o 3.1.1 Stage 1
               o 3.1.2 Stage 2
               o 3.1.3 Rescue
               o 3.1.4 Live ISO
               o 3.1.5 Hardware support
          + 3.2 Localisation (l10n) / Internationalisation (i18n)
               o 3.2.1 Manuals
               o 3.2.2 Software translations
          + 3.3 Package management
               o 3.3.1 New RPM
               o 3.3.2 DNF: the alternative package manager
               o 3.3.3 AppStream
               o 3.3.4 perl-URPM and urpmi
          + 3.4 Tools
               o 3.4.1 Mageia Control Center
               o 3.4.2 Other
                    # 3.4.2.1 MageiaWelcome
                    # 3.4.2.2 Isodumper
                    # 3.4.2.3 Docker
                    # 3.4.2.4 LiveCD Tools
                    # 3.4.2.5 draklive2
                    # 3.4.2.6 Memtest86+
                    # 3.4.2.7 remove-old-kernels
          + 3.5 Base system
               o 3.5.1 Kernel and hardware support
               o 3.5.2 dhcpcd replace dhcp-client
               o 3.5.3 dmesg
               o 3.5.4 Graphic drivers
                    # 3.5.4.1 X Window System (X11)
                    # 3.5.4.2 AMD video drivers
                         @ 3.5.4.2.1 Proprietary AMD driver
                    # 3.5.4.3 NVIDIA drivers
                         @ 3.5.4.3.1 Proprietary NVIDIA driver
                         @ 3.5.4.3.2 Optimus laptops
               o 3.5.5 Sound servers
               o 3.5.6 Bootloaders
          + 3.6 Desktop environments
               o 3.6.1 Plasma
                    # 3.6.1.1 liquidshell
                    # 3.6.1.2 sddm-theme-coffee-ng
               o 3.6.2 GNOME
               o 3.6.3 LXDE
               o 3.6.4 Xfce
               o 3.6.5 LXQt
                    # 3.6.5.1 LXQt with Wayland
               o 3.6.6 MATE
               o 3.6.7 Cinnamon
               o 3.6.8 Enlightenment
               o 3.6.9 Light window managers
                    # 3.6.9.1 IceWM
          + 3.7 Office apps
          + 3.8 Internet apps
          + 3.9 Multimedia apps
          + 3.10 Editors
          + 3.11 Games
          + 3.12 Education
          + 3.13 Software Development
               o 3.13.1 Compilers and tools
               o 3.13.2 Virtualization
                    # 3.13.2.1 VirtualBox
               o 3.13.3 Programming languages
          + 3.14 Server applications
               o 3.14.1 Nextcloud
               o 3.14.2 Veyon
               o 3.14.3 Kea
     * 4 Upgrading from Mageia 9
          + 4.1 Preparations
          + 4.2 Online-Upgrade
               o 4.2.1 Online-Upgrade, using mgaonline (GUI)
               o 4.2.2 Online-Upgrade, using urpmi (CLI)
               o 4.2.3 Online-Upgrade, using DNF (CLI)
          + 4.3 Using the installer to Upgrade
          + 4.4 Upgrading using the traditional DVD ISO
          + 4.5 Upgrading using the Netinstall ISO
          + 4.6 Upgrading an encrypted install
     * 5 Known issues
          + 5.1 User action needed
          + 5.2 Bugs
               o 5.2.1 Bug reporting
     * 6 Packages removed from the distribution
          + 6.1 Without removal on upgrade
          + 6.2 Replaced on upgrade
          + 6.3 With removal on upgrade

Introduction

   Mageia (from Greek μαγεία (magea) - magic, enchantment) is a
   free and open-source operating system from the GNU/Linux family of
   operating systems. Mageia is developed by a community of dedicated
   users, and backed by the non-profit organisation Mageia.org - a group
   of individuals elected by the Mageia Board. Whether you're a first-time
   GNU/Linux user, a software developer, an experienced system
   administrator or a casual web-surfer, Mageia is the right choice for
   you. Mageia can be installed on a computer as both the main operating
   system and an alternative to one or several other installed operating
   systems.

   Note that versions listed in this page are for the release medias.
   During a Mageia release lifetime we push thousands of updates and
   hundreds of backports packages. For example find here current lists of
   Mageia 10 x86_64 updates and backports packages.

Available installation media

   Mageia can be installed using three types of installation media:
     * Classic install ISOs (32-bit and 64-bit versions), which use the
       traditional DrakX installer. The ISOs contain all supported
       locales, a large variety of packages to choose from during
       installation (common desktop environments) and all non-free
       drivers. The use of non-free packages can be disabled during the
       installation. Note that by decision, Classic Installer now includes
       drivers for wireless connection, but you may need wired Ethernet if
       you wish to use online repositories for updates during install and
       wireless connection not works for you.

   These ISOs fit on an 8GB USB stick; for DVD, they no longer fit on a
   standard 4.7GB DVD, but need double-layer media.
     * Network install ISOs (32-bit and 64-bit versions, available in both
       free and non-free versions. Note: Net-install ISOs are not adapted
       to boot on 32-bit EFI) are minimally-sized and only contain a Stage
       1 installer, which contains only the most basic hardware support to
       boot, connect to a network and download a stage 2 installer. You
       may require the non-free version to obtain the necessary
       proprietary drivers, for example for WiFi connectivity. From this
       point onward, the installation process is very similar to that of a
       traditional ISO, the only difference being that all necessary and
       optional packages are fetched from remote repositories. Note: It is
       a good idea to perform a minimal installation, and continue the
       rest of the installation after booting to the target system. This
       is especially recommended during Mageia's development stages
       (alpha, beta, RC), where packages and files change frequently and
       unexpectedly. Instructions here.

     * Live ISOs can be used to boot directly into Mageia or to install
       Mageia to a fixed drive. The four Live installation medium choices
       includes three desktop environments to choose from; Plasma
       (64-bit), GNOME (64-bit) and Xfce (32- or 64-bit). It also contains
       all supported locales and comes with extensive hardware support, as
       well as an assortment of various packages, making the Live ISOs the
       simplest and quickest way to get started with Mageia. The Live ISOs
       support the memory persistence feature, which allows for
       preservation of user files and the customisation of the system at
       the next boot. The files can also optionally be encrypted. Thanks
       to this, you can now take Mageia and your files everywhere with
       you! Furthermore, you can also spin your own live installation
       medium!. Tip: To optimise updates, you can uninstall packages; see
       more here.

   All the Live Live ISOs fit on an 8GB USB stick. For DVD, the Plasma and
   Gnome Lives now exceed the capacity of a normal DVD, and require
   double-layer media. But the two Xfce Live ISOs do fit on a normal 4.7GB
   DVD.

   All ISO images can be burned to a DVD or dumped to a USB flash drive.
   For further information please see the Installation Media wiki page
   about how to choose, download, check, fix, burn, use the media, and
   restore USB stick.

   The different download options can be found on the download page. Both
   direct (FTP and HTTP) and BitTorrent downloads are available.
   Warning!
   Classic Installer and Plasma & Gnome Live ISOs no longer fit in single
   layer DVD, you should use Dual Layer DVD; both Xfce Live ISOs still fit
   on a normal single-layer DVD. 8GB USB devices suffice for all ISOs.

   About choosing ISOs: see the first chapter, "Select and use ISOs", in
   the installer manual.

   Install manuals are here.

The Mageia repositories

   The software packages that are included in Mageia reside in three
   different repositories, depending on the type of licence applied to
   each package. Here is an overview of these repositories:
     * Core: The Core repository includes packages with free and
       open-source software (FOSS). - i.e. packages licensed under a free
       and open-source licence, such as the GPL. The "Core" media, along
       with the "Core Release" and "Core Updates" software repositories
       are enabled by default.
     * Non-free: The Non-free repository includes packages that are both
       free to use and free to distribute, but that contain proprietary
       software (hence the name - 'Non-free'). This repository houses
       proprietary AMD/ATI and NVIDIA graphics card drivers, firmware for
       a various WiFi cards and more.

   The Non-free repository is enabled by default in the installer, but can
   be disabled if necessary.
     * Tainted: The Tainted repository includes packages which are
       released under a free license, but which infringe on patents and
       copyright laws in some countries, e.g., multimedia codecs needed to
       play various audio/video files, packages needed to play commercial
       video DVDs and so on.

   The Tainted repository is available but disabled by default, i.e., it's
   completely opt-in. It is a good idea to verify your region's laws
   before using packages from this repository.

32-bit repositories on 64-bit systems

   32-bit repositories are configured, but disabled by default on 64-bit
   systems. Some 64-bit programs such as Steam require dependencies found
   in 32-bit repositories. Therefore, if you would like to install
   software which depends on 32-bit packages, make sure that you have the
   "Core 32-bit Release" and "Core 32-bit Updates" repositories enabled in
   RPMDrake. Likewise, some 64-bit packages from the Non-free or Tainted
   repositories could depend on 32-bit packages from their respective
   repositories. Thus, it is strongly recommended to always enable
   repositories in pairs (32-bit together with 64-bit) so as to not
   encounter issues while updating.

Release highlights

32 Bit Support

   We increase hardware requirements for 32bit systems, you will require a
   CPU with SSE2 features. You will find that extension for the packages
   and the part for architecture in the name of the ISO images have
   changed from i586 to i686. Also, due most of the software projects are
   dropping 32bit support, you can find that the support is not as full as
   in the x86_64 systems.

Major developments

Installation

Stage 1

     * Since mageia 9 NFS support is done using system tools, thus gaining
       support for NFSv4 & co...

Stage 2

     * Ask for user's timezone at the start of installation.

   This allows us to set the system clock to the correct time. This is
   needed to prevent rpm verification failures when very recently built
   packages are fetched from network media. The new Sequoia PGP backend
   rejects packages that appear to have been signed in the future. This
   feature is available since beta1 ISOs.
     * Lots of bug fixes
     * Support for wireless connections. This feature is available since
       beta1 ISOs, tell us if works for you.

Rescue

   The rescue system has been enhanced.
     *

Live ISO

     *

Hardware support

     *

Localisation (l10n) / Internationalisation (i18n)

Manuals

     * The manuals for the traditional installer and for the Mageia
       Control Center have been (partially) translated into many more
       languages. See our official documentation
     * An English screenshot is used when a localized screenshot is
       unavailable for an HTML manual.
     * PDF and EPUB manuals are created only when more than half of the
       needed localized screenshots for those manuals are available.

Software translations

   New translations have been added, while others were improved. Thank you
   to our dedicated community of translators for your reliable work.

Package management

New RPM

   RPM has been upgraded to version 4.20.

   More information on changes from RPM 4.18 (which shipped with Mageia 9)
   to RPM 4.20 is available from the RPM website:
     * RPM 4.20.0 Release Notes

DNF: the alternative package manager

   DNF (Dandified Yum) was introduced as an alternative to urpmi since
   Mageia 6.

   DNF is a next-generation dependency resolver and high-level package
   management tool that traces its ancestry to two projects: Fedora's YUM
   (Yellowdog Updater, Modified) and openSUSE's SAT Solver (libsolv). DNF
   was forked from YUM several years ago in order to rewrite it to use the
   SAT Solver library from openSUSE and to massively restructure the
   codebase so that a sane API would be available for both extending DNF
   (via plugins and hooks) and building applications on top of it (such as
   graphical frontends and system lifecycle automation frameworks).

   DNF comes with enhanced problem reporting, advanced tracking of weak
   dependencies, support for rich dependencies (see the RPM release notes
   for more on this), and more detailed transaction information while
   performing actions.

   Mageia 10 ships with DNF v5.4.0.0, as DNF v5 has replaced DNF v4
   shipped in Mageia 9 and older.

   For more information on changes from DNF v4, see this documentation:
   https://dnf5.readthedocs.io/en/latest/changes_from_dnf4.7.html

   System upgrades using DNF are supported. See the section on upgrading
   with DNF in the release notes for more information.

   With fresh installations via the classical and live media, DNF will be
   installed in parallel with urpmi. Depending on the method used to
   upgrade to Mageia 10, it may be necessary to install the dnf5 package
   to have it available.

   For information on how to use DNF, please refer to the wiki page: Using
   DNF.

AppStream

   Our RPM-MD (RPM MetaData) repositories (used by DNF and PackageKit)
   provide AppStream metadata. Tools like GNOME Software (GNOME Desktop,
   packaged as gnome-software) and Plasma Discover (KDE Plasma Desktop,
   packaged as discover) leverage AppStream metadata to provide a rich
   experience when searching, identifying, and managing applications.

   AppStream is a cross-distribution effort for enhancing software
   repositories by standardizing software component metadata. It enables
   an application-centric view on package repositories and provides
   specifications for things needed to create user-friendly application
   centers.

   See the AppStream website for more information:
   https://www.freedesktop.org/wiki/Distributions/AppStream/

perl-URPM and urpmi

     * Doc has been enhanced (eg: URPM & urpm & CPAN)
     * urpmi/perl-URPM support a wider range of rpm versions, from rpm-4.9
       to latest 4.20, from perl-5.8 to perl-5.42
     * Various bug fixes have been made

Tools

Mageia Control Center

   Since Mageia 9, our sound manager, draksound, in MCC have been enhanced
   to easily switch between PulseAudio and PipeWire.

Other

MageiaWelcome

   The 'Welcome' screen is an application that is presented to users when
   booting into a fresh installation of Mageia. It has now been entirely
   reworked to have a linear approach, with successive steps following in
   a logical order of important things to know and do post-installation.
   By default, it will run at each subsequent boot, but this behaviour is
   optional. Even if the auto-run option is disabled - it can be invoked
   at any time as an application (mageiawelcome).

Isodumper

   Isodumper is a tool to write ISO images on memory devices. The
   interface has been reworked to allow successive operations to be done
   in one shot.

Docker

   With Mageia 10, the Docker ecosystem has been updated to latest and
   greatest versions of the tools ecosystem (version 29.1.3 of the client
   and 28.5.2 of the engine) and buildkit 0.31.1, docker compose 5.1.0
   (orchestration), containerd v2.2.1 (daemon controlling runC),
   opencontainer-runc 1.4.0, docker-registry v3.0.0 (share of images), and
   python-docker 7.1.0 (python 3 libraries for engine API management).

LiveCD Tools

   With Mageia 10, the LiveCD Tools have been rebased to the latest
   version (v31.0).

   For information on how to use the LiveCD Tools, please refer to the
   wiki page: Using the LiveCD Tools

draklive2

   The GUI mode has been enhanced to include the summary stage from the
   classical installer, allowing easy configuration of locales, timezones,
   system services, and firewalls. The individual package selection stage
   now includes a flat list mode, removing the restrictions on what
   packages can be selected.

   For more information, please refer to the wiki page: draklive2

Memtest86+

   PCMemTestT which was a fork was merged back into Memtest86+ memory test
   utility. So Memtest86+ replaces PCMemTest as the memory test utility on
   all the Mageia ISOs. It may also be installed on a user's system, where
   it will be automatically added to the system boot menu.

remove-old-kernels

   The tool which removes old kernels from systems. It works in the
   background without any user intervention and defaults to keeping the
   three most recently installed kernels. This resolves an issue which
   could cause systems with limited storage to run out of root partition
   space after many kernel updates. As well as the default automatic mode
   which is run weekly it may be configured and run manually from the
   command line. Run with -h option to see help. It is also available to
   be run from the Mageia main menu where it may be found under Tools ->
   System tools. There is also a man page which covers more detail for
   expert users.
   Note:
   If you upgrade from Mageia 9 the tool is not installed as part of the
   upgrade process.

   You need to install remove-old-kernels to get access to this tool
   mga#31642.

Base system

Kernel and hardware support

     * Mageia 10 ships with kernel 6.18.

   All hardware managed by this kernel version is enabled. The kernel
   provides better graphics with Mesa 3D 26.0.
     * Other kernel flavors are included, particularly, kernel-linus (a
       vanilla stock kernel without any extra patchset). See the wiki page
       Kernel_flavours for more information.
     * The Single-queue I/O schedulers were removed upstream since kernels
       5.0 . If you need ionice utility, consider installing a new
       ionice-scheduler package which enables BFQ scheduler for rotational
       disks.
     * cpupower and powersave

dhcpcd replace dhcp-client

   dhcpcd replaces the obsolete dhcp-client. Our network configuration
   tools have been adapted to use dhcpcd in replace of dhcp-client

dmesg

   dmesg is now configured to be accessible only to superadministrator.

Graphic drivers

   Mesa 3D has been updated to Mesa 3D 26.0.

X Window System (X11)

   Mageia 10 ships with X.Org 21.1.21 and XWayland 24.1.9.

AMD video drivers

     * Mageia 10 uses the free video drivers for AMD/ATI graphics cards,
       AMDGPU for newer cards and Radeon for older graphics cards.
       Compared with Mageia 9, hardware support has been increased and
       performance has been improved.
     * In case of a hybrid card, the solution exposed with the nouveau
       driver and the precommand DRI_PRIME=n is also working, at least
       with the Radeon driver.

Proprietary AMD driver

     * The proprietary AMDGPU-PRO driver currently only works with X.org
       1.1xx, so it cannot be used in Mageia 10. The OpenCL and HIP parts
       are being worked on, keep an eye on the Testing repo...

   no longer required? which hardware would not managed by recent libre
   AMD drivers?

NVIDIA drivers

     * The current libre Xorg Nouveau driver has enhanced hardware support
       and performance compared to Mageia 9.

     * We also have the Xorg modesetting driver (Which one that works best
       depends on your GPU.)

Proprietary NVIDIA driver

   NVIDIA's proprietary drivers are provided in the nonfree repositories,
   64 bit only:
     * Recent GPUs are supported by the R580 series driver packaged as
       "nvidia-current", chosen by "Geforce 745 series and later" in our
       tools.

          We also have "nvidia-newfeature", chosen by "Driver: New
          feature" - It is intended as alternative for newest cards - but
          note that we may not keep nvidia-newfeature up to date and in
          sync with kernel, and it may actually be less recent than
          nvidia-current. Both "nvidia-current" and "nvidia-newfeature"
          will apart from minor updates also jump to new Rxxx versions
          during a Mageia release lifetime. Actual version can be seen by
          the package version.

     * For older GPUs, we supply R470 series drivers "nvidia470", (same as
       for Mageia 9) chosen by "Geforce 635 to Geforce 920" in our tools.
       R470 was "nvidia-current" in Mageia 8, and some cards that used
       that then may now need to be manually set to R470. Note that it is
       not supported upstream and is not receiving security updates but we
       provide it as is for convenience of our users who choose to use it.
       nvidia470 packages are not provided on Mageia 10 Live ISOs but will
       be installed from our "nonfree" repository when you choose to. (And
       in Live you need persistence activated.)

          The 390.x driver series, which supported older graphic cards
          like the GF1xx series, is EOL (end of life) since the end of
          2022. Because the driver is not compatible with newer Kernel and
          newer X Server versions we had to drop it. Please try the free
          Xorg driver nouveau or modesetting.

     * CUDA and OpenCL are supported for "nvidia-current".

     * NEW: We now provide alternative opensourced nvidia kernel modules
       (in Mageia 9 since Dec 2024).

     * NEW: It is now possible to have nvidia driver loaded early, in
       initramfs. (in Mageia 9 since Jan 2025)

   For more information on all drivers see here.

Optimus laptops

   Some laptops comes with "Hybrid Graphics", meaning they have two GPU:
   one is usually "internal" (or "integrated") into the CPU, and is called
   IGP (Integrated Graphic Processor), and the other is "dedicated",
   external to the CPU, and it is called "discrete" (DGP,
   Discrete/Dedicated Graphics Processor). The integrated is power
   efficient, while the discrete is faster.

   Owners of NVIDIA Optimus laptops (integrated Intel or AMD/ATI CPU+GPU,
   plus a discrete NVIDIA GPU) now have three ways to benefit from the
   power of their NVIDIA GPU:
     * The free Nouveau drivers support Prime GPU offloading out of the
       box, which can be used via the DRI_PRIME=1 environment variable
       (unless the proprietary NVIDIA driver is in use by, e.g.,
       Mageia-prime). Refer to the Nouveau documentation to see how to
       configure X.Org to use NVIDIA Prime with DRI3.
     * As in Mageia 9, the Bumblebee package can be used to bridge the
       monitor to the NVIDIA GPU, allowing to access its processing power
       albeit with some overhead.
     * Mageia-prime can be used to configure the NVIDIA Prime supported by
       recent Linux kernels and X.Org servers. It allows to fully switch
       to using the NVIDIA GPU without the overhead of Bumblebee, and is
       particularly suited for use with CUDA.

   In all three cases, when configuring the graphics drivers, one must
   during install and the usual Mageia tools configure only the integrated
   GPU (at least in most Optimus configurations), as it is typically the
   only one physically connected to a monitor. (If failing, try the other
   way around.)

Sound servers

   Mageia 10 supports both PulseAudio and PipeWire as sound servers.

   By default both gets installed, but only PulseAudio is enabled.

   We here provide instructions on how to switch between PulseAudio and
   PipeWire backend. You can also use Mageia Control Center.

Bootloaders

     * GRUB2 has been updated to 2.12
     * For UEFI boot, the rEFInd boot manager is supported as an
       alternative to GRUB2.

Desktop environments

   All the desktop environments mentioned below are included in Mageia's
   online repositories, and can be installed in parallel on any Mageia 10
   system. Some of them are also included on the physical media, LiveDVDs
   and Classical DVDs, as specified in each section.

Plasma

   Plasma, the desktop environment from the KDE community, is provided as
   version 6.5.5, built on top of Qt 6.10 and KDE Frameworks 6.22 and with
   KDE Applications 25.12.

   For clean installations Plasma under Wayland is the default session, if
   you want to use X11 session, install task-plasma-x11 or
   task-plasma-x11-minimal, and it should appear in your favourite display
   manager's list of desktop environments at log in.

   For upgrades from mageia 9 you'll get Plasma (X11) and Plasma (Wayland)
   sessions, choose the desired.

   Note also that Wayland session with Nvidia's R535 (nvidia-current)
   nonfree driver is available by making sure that "nokmsboot" is removed
   and "nouveau.modeset=0" is passed to Kernel command line. - This is
   provided as Technology Preview for testers.

   The default display manager (DM) for the Plasma desktop environment is
   the Simple Desktop Display Manager (SDDM).

   Ksysguard is replaced by plasma-systemmonitor.

   Plasma has a specific 64-bit LiveDVD and it can also be installed from
   the Classical DVD ISO (traditional installer).

liquidshell

   liquidshell is an alternative to plasmashell

   It does not use QtQuick but instead relies on QtWidgets, therefore no
   hardware graphics acceleration is needed.

   In Mageia 10 liquidshell is included in the repositories, once
   installed you can see liquidshell as option in your Display Manager.

sddm-theme-coffee-ng

   We have work on enhance the presentation of mageia, as part of that
   work we include an alternative theme for sddm, sddm-theme-coffee-ng,
   let us know what you think!

GNOME

   GNOME 49 is provided. It now defaults to running on Wayland, but also
   provides an alternative "GNOME on Xorg" session. Note that with
   Nvidia's nonfree drivers, GNOME defaults to start an X11 session.

   For those preferring the GNOME 2 look and feel, GNOME 3 also provides a
   "Gnome Classic" session.

   GNOME "Flashback" is yet another alternative. It provides a similar
   user experience to the GNOME 2.x series sessions. The differences to
   the MATE project is that GNOME Flashback uses GTK+ 3 and tries to
   follow the current GNOME development by integrating recent changes of
   the GNOME libraries.

   GNOME has a specific 64-bit LiveDVD and it can also be installed from
   the Classical DVD ISO (traditional installer).

LXDE

   This very lightweight GTK+3-based desktop environment is still
   available and continues to receive improvements from upstream and our
   Mageia maintainer, even though its community has partly refocused on
   LXQt. LXDE cannot use PipeWire as sound server, only PulseAudio. Now
   Srain is the IRC client installed instead of Hexchat.

   LXDE can be installed from the Classical DVD ISO (traditional
   installer).

Xfce

   Xfce 4.20 is provided.

   Xfce has dedicated 32-bit and 64-bit LiveDVDs and it can also be
   installed from the Classical DVD ISO (traditional installer).

LXQt

   LXQt 2.3.0 is provided and included in the Classical ISO.

   To adjust the settings of the transparency compositor picom, in
   combination with the window manager openbox, you can install
   picom-conf.

   LXQt is now provided with Kvantum to allow the settings of various
   themes. It can also be used with Plasma.

LXQt with Wayland

   We provide task-lxqt-wayland and task-lxqt-wayaland-minimal in our
   repositories, you can install lxqt from the Classical ISO, after boot
   in the installed system add the online repositories and install one of
   the wayland task packages.

   You can choose the window manager you want to use. The options include
   kwin_wayland, labwc, niri and hyprland, install one of them before
   installing the task packages or you get some default selection by the
   package manager.

   Some things will not work, see the Errata page.

MATE

   MATE 1.28.0 is provided.

   MATE can be installed from the Classical DVD ISO (traditional
   installer). Due to DVD space considerations, some applications such as
   mate-screenshot (screenshot application) are not included in Classical
   DVD ISO. For a full MATE Desktop experience, users are advised to
   install task-mate package after initial installation.

Cinnamon

   Cinnamon 6.6 is provided.

   Cinnamon can be installed from the Classical DVD ISO (traditional
   installer).

Enlightenment

   The Enlightenment task package comes with E27.1 and Enlightenment
   Foundation Libraries (EFL) 1.28.1.

   Of course, Mageia includes E's Econnman UI for the connman connection
   manager (if enabled - default is systemd-networkd.service with the
   Netapplet), along with four EFL-based applications: the Terminology
   terminal emulator, the Ephoto image viewer, the light-weight Rage video
   player and the Evisum system monitor. Ecrire, a basic EFL-based text
   editor, is also available as a recommends.

   For those new to E, startup applications and processes (such as the
   Mageia Online Applet for update notifications) are not automatically
   picked up from /etc/xdg/autostart, but can be enabled at startup by
   going to Main menu > Settings > Apps > Startup Applications and adding
   the desired applications and system processes. Applications (only) to
   be loaded on restarting the DE are handled separately from a list
   available via Main menu > Settings > Apps > Restart Applications.

   Enlightenment's system tray, which uses SNI appindicator notifications,
   is a separate module that must be loaded (Main menu > Settings >
   Modules) and added to a shelf (panel), where the Mageia Online Applet
   and Netapplet will be displayed (when enabled) along with others.

   One issue has been observed: Restarting E sometimes results in a
   warning that the Efreet cache was not updated. In general, this can be
   ignored as it results from a time-out which still seems to be too short
   for some systems.

Light window managers

   You can also keep your Mageia 10 installation even more lightweight,
   and we provide for this a plethora of small and efficient window
   managers. You can find afterstep, awesome, dwm, fluxbox, fvwm2,
   fvwm-crystal, fvwm3, i3, icewm, jwm, matchbox, openbox, pekwm, sugar,
   swm, and windowmaker. After installation, they appear in the login menu
   of your display manager.

IceWM

   IceWM is installed by default as a backup desktop environment even if
   you select Plasma or GNOME in the installer. It is also present in all
   Live ISOs.

   To launch it you select "icewm-session" in the login menu of your
   display manager.

Office apps

   LibreOffice has been updated to 26.2.2. See official release notes for
   26.2 for details.

   Knotes has been replaced by Marknote. This one include a path for
   importing the notes.

   NoComprendo is a tools for voice recognition, including control of the
   desktop and dictation. It now uses Vosk libraries and models.

Internet apps

     * Chromium-browser have been dropped due to too much maintenance
       work. If you need it, install it as Flatpak; install
       app/org.chromium.Chromium/x86_64/stable, or Chrome Flatpak. Or use
       the Chrome RPM from Google.
     * Firefox has been updated to 140 ESR**
     * We added browsers for Gemini protocol: Lagrange (SDL), Kristall
       (Qt), Offpunk (CLI).

Multimedia apps

   Since the last patent expired in April, 2017, mp3 encoding is now
   available in the core media. Tainted media are still needed for H.264,
   H.265/HEVC and AAC encoding.

   DisplayCAL is a tool to calibrate colours of a display using a sensor.
   It comes back as it has been ported to Python 3.

   Blender for 3D animation is now in release 4.5.8.

Editors

     * Vim has been updated to 9.2
     * NeoVim 0.11.5 is also included

Games

   In the Mageia community, our love for free software extends to open
   source games. A huge effort has been made during the Mageia 10 release
   cycle to package many new games, making Mageia 10 a very good platform
   for intensive and casual gamers alike. You can check the Mageia App DB
   to see a list of available games clicking on the category you like.
   Also see Game environments, and Wine have been updated to version 11,
   significantly boosting some games.

Education

   Mageia 10 comes with gcompris-qt 26.1 which brings some new activities.

Software Development

Compilers and tools

   Glibc has been updated to 2.42.

   GCC has been updated to 15.2, GDB to 16.3 and Valgrind to 3.24.0.

   LLVM has been updated to 20.1.

   Firebird has been updated to 5.0.3

   IPython has been updated to 8.32.

   Most libraries were updated to recent stable versions (long-term
   support when available), such as Qt 5.15.16 and GTK+ 3.24.52.

   GTK4 is also provided at version 4.20.3.

   Tcl/Tk is at version 8.6.17.

   Ocaml has been updated to 5.3.0.

   Java stack has been updated to 17, java 8 and Java 11 are still
   available but are not the default. Java latest provides the latest java
   not released. Currently Java 21.

   Mono has been updated to 6.12.

   The MinGW stack has been updated.

Virtualization

   QEmu has been updated to 10.2

   libvirt has been updated to 11.10, virt-manager to 5.1.0, libguestfs to
   1.57.

   Some of libguestfs subpackages are now built from guestfs-tools 1.51.

   Xen is at version 4.20.2.

VirtualBox

   VirtualBox is at version 7.2.6.

Programming languages

   Python 3 has been updated to 3.13.

   Python 2 is being retired (most python2 modules have already been
   removed).

   Perl has been updated to 5.42.

   Ruby has been updated to 3.4.7.

   Rust is at version 1.94.0 It will be updated during Mageia 10's support
   life to follow new developments.

   PHP has been updated to 8.4 / 8.5 (to determine which will be the main
   version).

   Qt libraries are available both in 5.15.16 and 6.10.0, with Python
   bindings through PyQt5, PyQt6, PySide2 and PySide6.

Server applications

Nextcloud

   In Mageia 10 we brought Nextcloud server back, as well as the Nextcloud
   client.

Veyon

   This application that lets you monitor and control a group of computers
   replaces italc. It is available in version 4.9.7.

Kea

   Kea is ISC's replacement for their long lived but now obsolete and
   unsupported dhcp-server (dhcpd). It is not a drop-in replacement
   because the configuration syntax is very different and so will require
   manual intervention and migration (look at the keama package).

Upgrading from Mageia 9

   Upgrading from Mageia 9 is supported, and has been fine-tuned over the
   past few months.

   Also see How to choose the right Mageia upgrade method.
   Note:
   Please also read the Mageia 10 errata chapter "Upgrade issues".

Preparations

     * CHECK that the date & time in your machine is set correctly. The
       package signature is time/date sensitive. Updates and installations
       may fail without correct date & time settings.
     * Carefully read this document (Release Notes) and the Errata to see
       if there is something you need to prepare for.
     * Back up any important data.
     * Advanced users may have done changes that need to be reverted for
       problem free upgrade:
          + If third party repositories have been added, be sure to make a
            backup/copy of /etc/urpmi/urpmi.cfg. The info in that backup
            can be used if you later need to re-add them. DO NOT just
            restore the third party repo lines in urpmi.cfg. The file
            contents and the matching files in /var/lib/urpmi will be
            created when the repo is re-added.
          + If any package names have been added to /etc/urpmi/skip.list,
            remove them.
          + Disable or remove all debug and third party repositories shown
            by drakrpm-edit-media (MCC -> Software Management -> Configure
            media sources for install and update).
          + A 64 bit system must have any 32 bit development libraries
            uninstalled. You can identify these by the word "devel" in the
            name. To know if your system houses such libraries you can use
            the command:
            rpm -qa --queryformat "%{NVRA}\n" |grep i586 |grep devel
          + Remove packages now not in configured repositories, shown by
            urpmq --not-available. They may be re-installed after the
            upgrade if needed.
     * Perform a normal full system update (most importantly rpm and
       urpmi).
     * Is very important to reboot your system after installation of the
       updates from mga#34918 & mga#34920. The updated gpg key is needed
       for the migration to Mageia 10.
     * Some software may need special care, such as maybe not update
       Docker during system upgrade, see Docker above.
     * It is good to free some space, particularly uninstall old kernels,
       fat games...
     * Make sure you have a task-* package for your favourite desktop
       installed. This ensures no needed packages for the desktop will be
       missing after the upgrade. Example: task-plasma. If you don't need
       full Plasma set it is task-plasma-minimal. Other desktops follow
       the same scheme, like task-gnome, task-xfce, etc, some have the
       "-minimal" variant too.

   Not supported:
     * Upgrading directly from Mageia 8. (or earlier releases)
     * Using any of the Live images - due to the Live system being copied
       "as is" to the target system.
     * Upgrading a Mageia installation which was NOT in UEFI, towards a
       UEFI-mode.

   - In these cases, you have to do a fresh installation. (Possibly
   keeping the /home directory.)

Online-Upgrade

   The Mageia Update notification applet, Mageia Online, will notify you
   when a new Mageia release is available, and ask if you wish to upgrade.
   If you agree, the upgrade will be carried out from within your Mageia
   installation without any further steps being necessary.

   If you have disabled the applet, or it is not automatically running for
   some reason, you can upgrade manually either using the GUI (mgaonline)
   or the CLI (urpmi/dnf). Each method is outlined below.

   For any on-line upgrade method, first:
     * Fully update your system and check you have enough free space
       before starting the upgrade. At least 2 GB, depending on your
       configuration - see Note and safe method at Online-Upgrade, using
       urpmi (CLI) below.
     * Reboot so you are sure latest updates of various system parts is in
       use and work - especially make sure you use latest kernel ( minimum
       5.15.120-2 from updates or 6.0.8-3 from backport - for dkms to
       work, mga#31982 )
     * Ensure any screen lockers have been disabled.

   Note:
   Use a wired internet connection if possible, especially when you're
   using nonfree wlan drivers.

Online-Upgrade, using mgaonline (GUI)

     * Use Mageia Online icon in the system tray to start the upgrade.

   If it does not offer the upgrade:
     * Make sure that your system is fully up-to-date by applying all
       available updates.
     * In Mageia Control Center - Software Management - Configure Updates
       Frequency, make sure that the option "Check for newer default
       releases" is selected.
     * Look in your /home folder for a hidden directory, .MgaOnline. If
       there is a file mgaonline in that directory, then delete that file.
       After a reboot, the blue upgrade icon should appear when Mageia
       Online next checks for updates. If Mageia 9 has reached EOL, it
       will be orange and show a pop-up warning that Mageia 9 is no longer
       supported. Alternatively, you can launch the upgrade process by
       entering the following command in a terminal. It will notify you of
       the availability of the new Mageia 10 distribution, configure
       Mageia media sources and start the migration.

   $ su -c 'mgaapplet-upgrade-helper --new_distro_version=10'

Online-Upgrade, using urpmi (CLI)

   This method is useful when the root partition is encrypted as the
   booted system is already decrypting the partition. The best method for
   performing an upgrade is to use run-level 3 so that the X server and
   graphical environment is not running. Therefore, the upgrade should be
   cleaner using run-level 3 than using a terminal application as fewer
   programs are running which could potentially mess up the upgrade.

   Run-level 3 can be enabled by appending "3" to the kernel command line
   by editing it at boot and to get then a login prompt. Another option is
   to use the command: systemctl isolate multi-user.target

   If you have dnf installed, you will have to stop the dnf makecache
   timer, because it causes a crash of urpmi when run during the upgrade
   (see mga#25072). The commands are included below.

   It is recommended to run "script upgrade_log.txt" before launching the
   next commands to capture the upgrade messages just in case a failure
   occurs. The messages will be written in upgrade_log.txt file. Use
   "exit" to quit out of "script".

   Here are the general upgrade steps:
     * Become root in a terminal. All following commands must be executed
       as root:

          $ su -

     * Make sure your actual system is fully updated:

          urpmi --auto-update --auto --force

     * Disable dnf makecache (this step can be skipped when dnf is not
       installed):

          systemctl stop dnf-makecache.service
          systemctl stop dnf-makecache.timer && systemctl daemon-reload

     * Remove all of the existing media sources on your system:

          urpmi.removemedia -a

     * Add the Mageia 10 online sources, either:
          + Using the MIRRORLIST method (which will select a mirror
            automatically based on your geographical location). urpmi
            knows what to substitute for $ARCH.

                urpmi.addmedia --distrib --mirrorlist
                'http://mirrors.mageia.org/api/mageia.10.$ARCH.list'

   Warning!
   For 32bit systems,use i686 instead $ARCH
     *
          + Or using a specific media mirror. You can get the mirror_url
            using the Mageia mirrors web application:

                urpmi.addmedia --distrib <mirror_url>

     * Finally start upgrading. It's recommended to run this command twice
       because in the first run some packages may be downloaded but not
       installed:

          urpmi --auto-update --auto --force

   Note:
   It is often a good idea, when you have more than enough free disk
   space, to test the upgrade before carrying it out.
   With this command: urpmi --auto-update --auto --force --download-all
   --test all the packages are downloaded and the 'upgrade' is only a
   simulation. This needs a lot of free space before starting the test -
   like more than 2GB free space on /var partition (/ if you have no
   /var). (If you have several large desktops and many programs you may
   need more - if only a lightweight desktop, less.) If you have space on
   another partition, you can specify the destination of downloaded files
   by adding a path pointing to this partition after the --download-all
   keyword.
   If the result is good, then upgrade for real with the command urpmi
   --auto-update --auto --force --download-all (same but without --test).
   Add also the path of downloaded files if specified previously.
   If the result is not good, restore the Mageia 9 repositories with
   urpmi.removemedia -a and urpmi.addmedia --distrib --mirrorlist
   'http://mirrors.mageia.org/api/mageia.9.$ARCH.list' like above, and
   clean the cache by issuing urpmi --clean.

Online-Upgrade, using DNF (CLI)

   If you're using (or now change to use) DNF for software management
   (configured appropriately per our wiki page on using DNF), you can
   upgrade Mageia in just a few steps.
     * Become root in a terminal. All following commands must be executed
       as root:

          $ su -

     * Make sure your actual system is fully updated:

          dnf upgrade --refresh

     * Install the system-upgrade plugin:

          dnf install 'dnf-command(system-upgrade)'

     * Start download of Mageia 10 packages and check of possible
       conflicts:

          dnf system-upgrade --releasever 10 download --allowerasing
          This command asks for confirmation and tells the required disk
          space before starting the download. If you do not have what it
          says plus a couple of hundred MB free space on /var partition
          (if /var is not separate but part of / partition, add another
          couple hundred MB), then either make enough space or add the
          option --downloaddir path_to_directory_with_free_space to this
          and the next system-upgrade commands. Also, if you have a
          separate /boot partition make sure it has space for adding two
          kernels. Also make sure / have additional room for the larger
          new programs. When you know all kinds of space is enough, say
          yes to let it download. It will also dry run a transaction test.

     * If downloading and transaction test succeeded, save your work and
       close applications!

          The next command will immediately reboot your system!

     * Finally start the upgrade:

          dnf system-upgrade reboot

Using the installer to Upgrade

   You can use both the minimal Netinstall, and the big traditional (so,
   non-Live) DVD ISOs to do clean installs, but also to perform an
   upgrade.
     * DVD contain a lot of packages. Drawback: some wifi could not work.
       (Due to lack of space. Drives also would need to be loaded at boot
       to work.)
     * Netinstall downloads everything. The nonfree version contain a lot
       of drivers, wifi is better supported.

   That means that if wired ethernet is not available, you must use
   nonfree Netinstall for connecting using wifi, because updating need
   connection to repositories. - See warning below.

   If you have wired ethernet you can choose either, Netinstall or
   traditional DVD ISO. The DVD is larger in initial download, but less
   need be downloaded during upgrade.

Upgrading using the traditional DVD ISO

     * Follow Preparations above.
     * Take note on what repositories are enabled (and have been enabled
       and installed from any time!)
     * Make sure you have wired internet on the computer to upgrade! (Else
       use netinstaller instead, for wifi.)
     * Download the ISO from the Mageia download page and burn it on a
       DVD, or dump it on a USB stick. For more details, have a look at
       this Available installation media article.
     * Boot from the created media and make sure it booted in the same
       mode (legacy/BIOS or UEFI) as Mageia 9 was installed in.
     * Select "Install Mageia 10" from the GRUB (the bootloader) menu.
     * Select the upgrade option.
     * When at the Media selection dialogue, add the repositories as you
       noted down above. (Usually by selecting "Network (http)", Next.)

   Warning!
   Upgrades attempted without setting up the online repositories are not
   supported.

   It is important that the online repositories be set up during the
   upgrade as the DVD ISO only includes a subset of the complete package
   set in Mageia online repositories, and:
     * You have probably over time installed software that is not on the
       ISO, only in the online repositories.
     * If you use important 32-bit packages in an otherwise 64-bit
       install, because the 64-bit ISO will only contain the 64-bit
       packages, the upgrade is likely to fail if you do not add online
       repositories.
     * By increased time after release is increasingly plausible that your
       system have received updates to later versions of software than
       that available on the ISO.

   On the first reboot after upgrade, use the command 'urpmi
   --auto-update' to make sure all packages were updated. In case of
   problems see If upgrade failed.

Upgrading using the Netinstall ISO

   Follow the same instructions above as for traditional DVD installer, it
   is very similar.

   Also see Mageia Netinstall ISO.

Upgrading an encrypted install

   Using Netinstall or DVD ISO.

   Firstly, on the running system to upgrade:
     * Remove unnecessary kernels, and big programs you do not need.
     * Perform a full update.
     * Make a note of which media are used, and have been used (Are any
       tainted enabled? If it is a 64-bit system, are any 32-bit media
       enabled?).
     * Make a note of which partitions are used, and their mount points.

   Then prepare and boot the traditional installer as described above,
   and:
     * Select install, select language, accept the licence, select
       country, select keyboard, custom partitioning.
     * Click your encrypted partitions, select Use and enter your key.
     * If it is LVM a new tab containing the LV partitions appears.
     * Assign the mount points for all needed partitions except swap (as
       per your notes as above, or judge from partitions name, size, and
       type. Don't forget the /boot outside of the encrypted LVM!).
     * IMPORTANT: After clicking Next make sure to deselect formatting of
       all partitions! Or, if you want a fresh system but wish to keep
       user data: format /boot, / and any /usr /tmp etc you might have,
       but NOT /home.
     * You should enable all media repositories (using your notes as
       above) corresponding to those used in your previous Mageia
       installation - except backports.
     * As with a nonencrypted install, it is recommended that the online
       repositories be set up, including relevant update repositories.

Known issues

User action needed

   User actions needed that are not described elsewhere on this page nor
   in Errata.

   Dovecot, the IMAP server, has been upgraded to 2.4.2, which has a
   configuration file that is not compatible with the old 2.3
   configuration. Please carefully review upgrade documentation on
   dovecot.org .

Bugs

   See the Errata page.

Bug reporting

   We have a bug tracker. Before reporting any bugs, please read the
   Errata and also search the bug tracker to see if the issue is already
   reported. - If it is, then maybe you can add valuable information, or
   help testing a proposed update. To contribute, you need a Mageia
   account, which you can create at https://identity.mageia.org/. If you
   don't know, see how to report a bug.

   You are also welcome to our Forum. For the development phase visit the
   section "Testing : Alpha, Beta, RC and Cauldron".

Packages removed from the distribution

Without removal on upgrade

   The following packages have been removed from the distribution. They
   won't be affected by the upgrade process - they should continue to work
   on systems that had them before the upgrade, but won't receive any
   support. Moreover, they won't receive any updates, which means they are
   likely to get outdated from upstream versions first, and potentially
   get exposed to security issues second - if not already. You should
   probably switch to an upstream version, or a better maintained
   alternative but that's your own decision.

   The category contains the following packages, alphabetically:
     * sparkleshare

Replaced on upgrade

     *

With removal on upgrade

   The following packages have been removed from the distribution and
   marked as obsolete in the task-obsolete package: they will be removed
   by the upgrade process.

   This category contains the following packages, alphabetically:
     *
