Available installation media

Mageia has two distinct installation media types:

For more information have a look at the installation media page.

You will always find the download info on the Mageia download page; direct (ftp and http) and BitTorrent downloads are available.

The Mageia online repositories

The Mageia software sits in three different repositories/media, depending on the type of license applied to each package. Here's an overview of those repositories:

Major new features


Stage 1

eg instead of

List of all change since Mga2

Stage 2

List of all change since Mageia 2.


It's now possible to rebuild stage 1 & stage 2 packages with a debug option in order to have better environments for debugging the installer.


Package management

RPM has been upgraded to 4.11.

Urpmi has been refactored and cleaned. Various bugs have been fixed :

Various enhancements have been done:

List of all the change since Mageia 2.

API change

The --repackage option has been removed (it had not worked since rpm-4.6 was introduced in 2009). Repository metadata can now be compressed with XZ instead of gzip.


Urpmi will now warn

The "download-all" option is supported in urpmi.cfg as opposed to being available only from the command line.

Graphical package manager

Rpmdrake wasn't properly highlighting latest changes in package changelogs when they used Epoch.

Updates were sometimes wrongly deselected when clicking on "New dependencies".

The --merge-all-rpmnew option is slightly faster. It also now consider all config files, including those outside /etc.

Rpmdrake now display a global progress bar when updating/installing or removing packages instead of one progress bar per RPM transaction.

List of all the change since Mageia 2.


Quite a lot of bugs were squashed. Some notable features:

Base system




File systems





/usr move

Also make it easy to take snapshots (when combined with btrfs or lvm) or share it over the network.


Mageia Control Center -> Boot. To test grub2 while still using grub legacy please see /usr/share/doc/grub2/README.Mageia

Note: If grub2 is installed "to a partition" during installation please read the Mageia-3 errata for more help.


Package compression

Packages are now compressed as XZ instead of LZMA

Easier debugging

By default, minimal debuginfo is installed in order to increase the quality of bug reports and allow easier support for profiling and userspace tracing. Developers will receive better bug reports by default, without users having to enable debug media and install big debug packages.

It will also make system-wide profiling, userspace dynamic probes and casual debugging easier.

RPM groups

The Mageia package groups have been reorganized to improve clarity and for easier browsing in rpmdrake and during installation.

Mass rebuild

Mass rebuild has been completed. The 10,500 source packages were rebuilt in three days on four nodes. Thanks to our packager, we are close to having 100% rebuild success.

This will improve the quality of Mageia 3 and also post-product support (bug or security updates), won't need to spend time fixing stuff that should already work.

Graphical environments


KDE 4.10.2.

Starting with KDE SC 4.7 we're providing an additional package name, vanilla, in order for an end user to simply use upstream configuration for desktop and applications. You simply need to install the vanilla-kde4-config package via rpmdrake or via urpmi like this:
urpmi vanilla-kde4-config


GNOME environment is also provided. Currently 3.6.


LXDE version 0.5.5 is available. LXDE is a desktop environment intended to be lightweight, fast, and energy-efficient.


Xfce 4.10 with various (bug) fixes mainly from upstream.

Available at install in the 'other desktop' checkbox with the classical iso.


The e17 release of the Enlightenment desktop environment is available in the Core repositories.


Beta 3 comes with RazorQt v. 0.5.2: "Razor-qt is an advanced, easy-to-use, and fast desktop environment based on Qt technologies. It has been tailored for users who value simplicity, speed, and an intuitive interface. Unlike most desktop environments, Razor-qt also works fine with weak machines".


Office apps


Steam for linux is now available in the repositories.


Computer Assisted Music

Audio and MIDI Connection Kit

Multitrack audio recorder



Score editors

Software Development

Upgrading from Mageia 2

Upgrading from Mageia 2 is supported, and has been fine-tuned over the past few months, so it should work. But as always, it's very advisable to back up any important data before upgrading and make sure you have made all updates of Mageia 2 (such as rpm and urpmi). Upgrading from Mageia 1 or another distribution is not supported.

There are several ways to upgrade from one of the previous Mageia releases:

Warning: Upgrading an existing install using a LiveCD is NOT supported due to the livecd image being copied "as is" to the target system.

Upgrading via the Internet

The Mageia update notification applet, Mageia Online, will notify you that 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). Both methods are outlined below.

First make sure you have the latest updates for your currently running release prior to upgrading. Because of the complications of the usrmove, a newer version of mgaonline is required to see the new version and step you through the upgrade process. You must therefore update mgaonline. The new mgaonline package will itself install the mageia-prepare-upgrade package.

Upgrading online, using mgaonline (GUI)

As noted above you must have the updated mgaonline installed.

The new mgaonline should inform you that a new release is available and will automatically tell you that preparation is required before continuing. It will then:

If you don't see mgaonline notify you that there is an new release, check your option with mgaapplet-config


mgaapplet-upgrade-helper --new_distro_version=3

It will notify you of the availability of the new Mageia 3 distribution, configure Mageia media sources and start migration. Again, please ensure you have the updated mgaonline installed before undertaking this stage.

Upgrading online, using urpmi (CLI)

urpmi.removemedia -a
urpmi.addmedia --distrib --mirrorlist$ARCH.list
(Where $ARCH is either i586 or x86_64)
urpmi.addmedia --distrib <mirror_url>
You can get the mirror_url using the Mageia mirrors web application
urpmi --replacefiles --auto-update --auto

Using the Mageia 3 DVD to Upgrade

You can use the Mageia 3 DVD to do clean installs but also to upgrade from previous releases.

To upgrade:

It is recommended that the online repositories be set up, if possible, during the upgrade as the DVD only includes a subset of the complete set of Mageia online repositories.

On the first reboot use the command line 'urpmi --auto-update' to make sure all packages were updated.

Known issues

See Errata page

Bug reporting

You can find our bugzilla here, but please read the Errata before reporting any bugs. If you don't already have a Mageia account, you can create one at If you don't know how the procedure works, please read how to report a bug first.