Skip to main content

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

📜 Table of Contents

  1. Installing Nitrux
  2. Upgrading From Previous Versions
  3. Minimal ISO Information
  4. Misc. Information
  5. Virtualizing Nitrux
  6. Virtual Appliances Information
  7. Managing AppImages
  8. Live Session
  9. Latte Layouts
  10. Support for Other Self-Contained Formats
  11. Alternative Stores
  12. Installing Steam
  13. Using Wine
  14. Nvidia Proprietary Driver Information
  15. Wayland Information
  16. PipeWire Information
  17. Updating MESA
  18. Lutris Information
  19. Kvantum Theming

🗒 Notes

Installing Nitrux

  • Check this tutorial to install the distribution.
  • We have added the ability for users to perform full-disk encryption during installation when using the automated partition options in Calamares (Replace partition and Erase disk).
    • In our testing, encrypting multiple partitions (if the user selected Manual partitioning) results in a broken system.

Upgrading From Previous Versions

  • To upgrade from the previous version of Nitrux (2.1.1) with NX Desktop to version 2.2.0, do the following (assuming a fresh installation).
pkcon refresh && pkcon get-updates
pkcon install linux-firmware
pkcon install nitrux-repositories-config nx-desktop-appimages-legacy
pkcon refresh && pkcon update
pkcon repair && pkcon update
pkcon repair
sed -i 's+Parachute+Overview+g' $HOME/.config/touchegg/touchegg.conf
cp -r /etc/skel/.config/{Maui,Nitrux} $HOME/.config/
cp -r /etc/skel/.config/latte/nx-* $HOME/.config/latte/
sudo reboot
  • To upgrade from the previous version of Nitrux (2.1.1) without NX Desktop (a.k.a, Minimal) to version 2.2.0, do the following (assuming a fresh installation).
pkcon refresh && pkcon get-updates
pkcon install linux-firmware
pkcon install nitrux-repositories-config
pkcon refresh && pkcon update
pkcon repair && pkcon update
pkcon repair
sudo reboot

Please note that starting from version 2.1.1 to manage Debian packages users should use PackageKit (pkcon).

Minimal ISO Information

  • To install other desktop environments using the minimal ISO, see Installing other DEs in Nitrux.
  • When installing the meta-packages to add other desktop environments in the minimal ISO, depending on the meta-package, it may or may not include the complimentary utilities such as a file manager, text editor, terminal emulator, web browser, etc., or additional hardware drivers. As well as customizations of any kind, this is not a bug.
  • Super+T opens the terminal.
  • Super+L switches the keyboard layout.
    • By default, ‘latam’ and ‘us’ layouts, so make sure to adjust this setting to your keyboard layout.
  • The JWM configuration file is ~/.jwmrc.
  • To start Calamares in the minimal ISO, run the following command.
sudo -E calamares -d

Misc. Information

  • We also include a simple text file called installed_pkgs.txt in the root that, as its name suggests, lists all installed packages by default in the distribution. This file is present in both ISO files, and users can use it to compare more extensive changes from release to release, like package updates.

Virtualizing Nitrux

  • OpenGL acceleration is used by default if you use Nitrux in a VM. Disable the compositor in System Settings and utilize a lighter alternative like xcompmgr.
  • To utilize 3D acceleration in a hypervisor like VirtualBox, please use the guest additions ISO from Oracle, do not use the Debian packages from the repositoriesPleasese use the package open-vm-tools-desktop from the repository for VMware Workstation and VMware Player. After installing the
    • VirtualBox guest additions using the ISO, do not remove the ISO and reboot; remove the ISO from the VM after successfully booting to the session.
  • When creating a new virtual machine in VirtualBox, the graphics controller selected is VMSVGA; starting with VirtualBox 6.1.34, users can change the screen resolution in System Settings.

Virtual Appliances Information

  • We’ve added two virtual appliances for those interested in trying Nitrux in a virtual machine (download links in Release Announcement). The virtual appliances are created using VirtualBox 6.1.26. Below is a comparison table of the virtual appliances’ default configuration.
    • If you’re creating a virtual machine of your own, we recommend using the settings in the table below.
  • After adding the virtual appliances, Users can configure their hardware settings to fit the host capabilities.
  • The password for the virtual appliances and the default user is nitrux.
  • Where applicable, no extra software (other than the Oracle Guest Additions) is installed.
Default VM Configuration Standard (w/ NX Desktop) Minimal (w/o NX Desktop)
General Encrypted Storage
System Motherboard, CPU, RAM 6GB RAM
6 CPU Cores
800MB RAM
1 CPU Core
EFI, VT-x/AMD-v, KVM, nested paging
ICH9
Screen Graphics Controller 128MB 16MB
VMSVGA
3D acceleration 🚫
Storage SATA 4x Ports w/ host cache
Audio PulseAudio, Intel HD Audio
Network Intel 82545EM Server
Serial Ports 🚫
USB USB 3.0 🚫
USB 2.0, 1.1
Extras Guest Additions from ISO 🚫

Managing AppImages

  • The managed locations (and thus the default) for AppImages in Nitrux are /Applications and ~/Applications.
  • AppImages launched from the application menu will be launched using firejail for sandboxing by default.
  • Some AppImages refuse to run when using Firejail but will run otherwise when using a specific flag. This problem is most visible with some Electron applications or Chromium-based web browsers. To run these AppImages, append the following Chromium flag.
electron-app.AppImage --no-sandbox
chromium-based-browser.AppImage --no-sandbox
    • We strongly emphasize that we do not recommend running AppImages without the sandbox, especially web browsers.

Live Session

  • The default user is nitrux, and there’s no password.

Latte Layouts

  • We include three layouts for the desktop, two are variations of a default top panel and bottom dock, and the other is a single bottom panel. To change between them, right-click the dock or the panel.
    • Note: Using the Global Theme KCM and checking “Use desktop layout from theme” does not change the layout and will cause issues with Latte.

Support for Other Self-Contained Formats

  • The Flathub repository is not added by default. However, it can be easily added using Plasma Discover by going to Settings>Add Source or using the terminal and running the following commands.
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Alternative Stores

  • Users can install Plasma Discover using the terminal to manage Flatpaks and Debian packages and their repositories.
pkcon install plasma-discover

Installing Steam

  • Users can install Steam from the applications menu.
    • Disclaimer: We do not develop Steam, Flatpak, or the Steam Flatpak.

Using Wine

  • Nitrux is exclusively a 64-bit Linux distribution; however, users can install software like Steam (32-bit) using Flatpak and Bottles (AppImage/Flatpak) to run Windows software.

Nvidia Proprietary Driver Information

  • We have added another ISO that includes the Nvidia proprietary driver without our X11 configuration by default; see Release Announcement.
    • These ISOs are not served from this website’s front-end but only from the links below.
      • Both ISO files use NX Desktop.
    • The first of these ISO files includes the latest (as of this post) version of the Nvidia proprietary driver (515.48.07), and the second of these ISO files includes the Legacy Nvidia proprietary driver (390.151). It’s targeted at computers using Nvidia hardware unsupported by the latest driver and where Nouveau doesn’t work adequately.
  • For some laptops, it may be necessary to add our X11 configuration for PRIME (where supported) to work correctly.
      • The command below will install the driver, the driver settings program, the PRIME command, and our X11 configuration for the Nvidia driver. After installing the package, the default PRIME profile will be on-demand for laptop users.
    • The default TTY for the graphical session can change if your computer utilizes the Nvidia proprietary driver.
pkcon install nvidia-x11-config

Wayland Information

  • The Plasma (Wayland) session works better with Intel and AMD graphics cards and Nvidia graphics cards using the Noveau driver. Additionally, the session can work with Nvidia graphics cards utilizing the proprietary driver, albeit with reduced performance.
    • We’ve recently removed the package from the default installation, but users can install it using the following command.
pkcon install nx-desktop-wayland-legacy plasma-workspace-wayland

PipeWire Information

Updating MESA

  • We also offer users the possibility of using Git builds of MESA to complement the performance gains from utilizing either the two new kernel options, Liquorix or Xanmod. To do this, run the following commands.
pkcon install mesa-git && pkcon update

Lutris Information

  • Users can install Lutris in the distribution from our repository. To do this, run the following commands.
pkcon install lutris

Kvantum Theming

  • Using the Global Theme KCM does not alter the Kvantum theme; to properly change the Kvantum theme, use Kvantum Manager.
  • The Kvantum theme does not pick up the color scheme selected using the Colors KCM since the Kvantum SVG theme engine does not work. When Kvantum is used, the color scheme complements the Kvantum theme, as the theme already provides the colors for the UI widgets.
  • Discover, and the Maui apps use QML, not QtWidgets like System Settings, Ark, KCalc, etc. So they are not themed to the full extent that QtWidgets apps are because Kvantum does not support QML adequately.
  • Both Kvantum themes support transparency and blur, but it’s not enabled by default.