Skip to main content

Below is a list of release notes we recommend reading before installing the distribution.

📜 Table of Contents

  1. Installing Nitrux
  2. Virtualizing Nitrux
  3. Filesystem, Security, Privacy, and Anonymization Features Information
  4. Upgrading Nitrux from a Previous Version
  5. Using NX Desktop
  6. Software Management
  7. Creating and Managing Backups
  8. Creating OpenRC and User Services
  9. Creating Network Shares
  10. Support for Other Desktop Environments
  11. Wayland Information
  12. PipeWire Information
  13. MESA Information
  14. Plasma X11 Session Information
  15. Latte Dock Information
  16. NVIDIA Proprietary Driver Information
  17. General Gaming Information
  18. Using Kernel Boot to swap Kernels
  19. Using VMetal in Nitrux
  20. Using Hypervisors in Nitrux
  21. Misc. Information

🗒 Notes

Installing Nitrux

Disclaimer: We do not develop the Calamares installer. Please create issues at its bug tracker here to request features or report problems.

Virtualizing Nitrux

  • To install the distribution on a virtual machine, see Virtualizing Nitrux.
  • Since Nitrux 3.2.1, users can use shared folders in hypervisors that use SPICE by using WebDAV, i.e., GNOME Boxes. To connect to a shared folder, do the following.
    1. Open the Index file manager and click the edit button in the URL bar.
    2. Enter the following URL and hit Enter.
webdav://localhost:9843/

Disclaimer: We do not develop VirtualBox, GNOME Boxes, or VMware Workstation/Player. If you have issues with these hypervisors, such as graphical problems, please inform their developers at their respective bug trackers.

Filesystem, Security, Privacy, and Anonymization Features in Nitrux

Upgrading Nitrux from a Previous Version

Using NX Desktop

Software Management

  • Nitrux is a distribution that doesn’t revolve around a package manager like other distributions; in Nitrux, the preferred method of obtaining new software is using AppImages. However, we understand that not all software is available as an AppImage. So, by default, we have included various options for users, such as Flatpak and Distrobox, to complement AppImages.
  • Users can also create their AppImages; to do that, see the following tutorials.

Creating and Managing Backups

  • Nitrux allows users to back up their data using Kup since version 1.1.9 (July 27th, 2019). You can find Kup in System Settings>Backups.

Creating OpenRC and User Services

Creating Network Shares

Support for Other Desktop Environments

  • By default, Nitrux uses the Plasma desktop with our customization layer, NX Desktop. Our desktop shell, Maui Shell, is being developed. Our focus is on Plasma and MauiKit. However, users can install other desktop environments using Distrobox. For more information, see our tutorial, Installing other DEs in Nitrux.
    • ⚠️ Important: Using Distrobox to install other desktop environments is a feature considered “an experiment” by the Distrobox developer, so keep that in mind.
  • Regarding Maui Shell, as of September 1st, 2023, Maui Shell development focuses on Qt6. Therefore, for now, we’re not providing new ISO files. To test Maui Shell, please compile it using a container.
    • ⚠️ Important: Please report issues with Maui Shell at its bug tracker.

Wayland Information

  • Starting with Nitrux 2.8.1, the distribution uses a Wayland session (Plasma Wayland) by default.

PipeWire Information

  • Since Nitrux 2.6.0, the distribution includes PipeWire by default.

MESA Information

  • Due to a significant issue with MESA from Git preventing any keyboard input, Nitrux no longer includes development versions of MESA.
  • If using a graphics processor that uses MESA drivers and the GUI does not work, check whether your GPU is loading its firmware. To check, run the following command after logging in to a TTY.
lspci -v | grep -A 10 -i "VGA compatible controller"
lshw -C display

Disclaimer: We do not develop or package MESA. To file bugs against MESA, please use their bug tracker here.

Plasma X11 Session Information

  • Starting with Nitrux 2.8.1, the Plasma X11 session is no longer the default. However, we understand that Wayland may not provide the best experience for many users, especially those with NVIDIA graphic processors. For these users, run the command below to restore the Plasma X11 session as a selectable session in SDDM.
sudo mv /usr/share/xsessions/orig.plasma.desktop.bak /usr/share/xsessions/plasma.desktop

Latte Dock Information

  • As of July 2022, Latte Dock is now unmaintained by its developer, meaning there’s no guarantee it will continue to work. Since Nitrux 2.9.0, Latte Dock is no longer included in the distribution.

NVIDIA Proprietary Driver Information

Please note that starting from version 2.5.0 Nitrux includes the latest available NVIDIA proprietary driver.

  • Nitrux includes the latest version of the NVIDIA proprietary driver when we build and publish our ISO files.

Disclaimer: We do not develop the NVIDIA proprietary driver. For issues with the NVIDIA driver, including bugs and adding support for graphics cards, please visit NVIDIA Support.

  • For some laptops with supported discrete graphics through the NVIDIA proprietary driver, adding our X11 configuration for PRIME (where supported) may be necessary to work correctly.
    • Download the script below to add our X11 configuration if your laptop requires it.
      • ⚠️ Important: The script file below creates files in the root directory; see XFS Features and Root Immutability in Nitrux.
      • 🔰 Information: The default TTY for the graphical session can change if your computer utilizes the NVIDIA proprietary driver.
mount -t devtmpfs dev /dev
mount -t devpts devpts /dev/pts

axel -a -o /usr/bin https://raw.githubusercontent.com/Nitrux/storage/master/Other/nvidia-x11-laptop-conf
chmod +x /usr/bin/nvidia-x11-laptop-conf

nvidia-x11-laptop-conf

rm -f /usr/bin/nvidia-x11-laptop-conf

sync

umount /dev/pts
umount /dev

exit

General Gaming Information

  • Nitrux uses the Liquorix kernel, described as “an enthusiast Linux kernel designed for uncompromised responsiveness in interactive systems, enabling low latency in A/V production, and reduced frame time deviations in games.”

Disclaimer: We do not develop, maintain, or package the Liquorix kernel. Please file bug reports at their bug tracker or ask for assistance on their forums.

Disclaimer: We do not develop Steam or the Steam Flatpak. To report issues about the Steam Flatpak, create an issue at their bug tracker. Also, we do not develop Bottles, Heroic Games Launcher, or Lutris. Please create an issue at their respective bug trackers to report problems with these applications.

  • Nitrux includes a desktop launcher to install the itch.io Store application, which will download and run the official Linux installer; we do not include it by default.
    • 🔰 Information: For more information about running the itch.io Store application in Nitrux, see itch.io Store.

Disclaimer: We do not host, maintain, or create the content at the itch.io Store, nor develop the itch.io client Store application. Please file bug reports at their bug report website here.

Using Kernel Boot to swap Kernels

  • The Kernel Boot (kboot) utility provides a solution to make it friendlier to load other Linux kernels on the fly. kboot is designed for a particular purpose, making it easier to allow for a faster transition from the currently running kernel to a new kernel and avoiding the time-consuming hardware initialization and bootloader stages. It performs the following steps:
    1. Reads the settings in the specified configuration file.
    2. Then, it uses kexec to load the selected kernel using the parameters from the configuration file.
  • In kernel-related topics, to manually build kernel modules using DKMS, see our tutorial about Building DKMS drivers in Nitrux.

Using VMetal in Nitrux

  • VMetal allows users to run Windows in parallel to Nitrux to provide users access to Windows software. Meanwhile, they can still use their Linux desktop at the same time. VMetal uses QEMU and KVM (Kernel-based Virtual Machine) on the software side and VFIO and IOMMU on the hardware side, meaning that Windows directly accesses the hardware it utilizes.

Disclaimer: Due to the magnitude of possible hardware combinations and UEFI firmware versions, we cannot guarantee that a specific hardware combination will work out of the box when using VMetal. We do not possess the means to test or acquire every consumer available product for verification that it will work in VMetal. We have tested VMetal only on the computers we have access to that meet the criteria. Therefore, YMMV. If VMetal works in your hardware configuration, please use hw-probe to let us know what hardware you’ve used.

Using Hypervisors in Nitrux

Misc. Information

  • We have discontinued minimal ISO releases of the distribution.
  • We have discontinued OVA releases of the distribution.
  • Nitrux is exclusively a 64-bit Linux distribution; we do not use, include, or provide support for 32-bit software.
  • Nitrux includes a simple text file called installed_pkgs_end.txt in the root directory. As its name suggests, this file lists all installed packages by default in the distribution. Users can use it to compare more extensive changes from release to release, such as package updates.
    • To view the list of packages, use Nota or the command cat. When using cat to look for a specific package, use grep, for example, to search for Mauikit.
cat /installed_pkgs_end.txt
cat /installed_pkgs_end.txt | grep mauikit
  • Nitrux has various command-line utilities, including a file manager, text editor, web browser, remote desktop, system monitor, and a single game. Below is a list of these command-line utilities.
    • ftp, hdparm, htop, links2, mc, micro, ncdu, tmate, tree, and nsnake.
  • We recommend users who wish to run prelink manually do it after using overlayroot-chroot; see XFS Features and Root Immutability in Nitrux. To run prelink manually, run the following command.
prelink -amR