Linux

How to install Nitrocid KS on Linux

We now officially support Arch Linux as the distro for 64-bit (AMD + Intel and ARM) processors!

Installing Nitrocid KS on Linux is straightforward, but we recommend installing the simulator using the manual unpack method.

Before performing the installation, your Linux system must meet the following requirements:

Extra kernel add-ons may require additional hardware on your computer to work. For example, the BassBoom addon requires that you have audio drivers installed on your computer.

To run Nitrocid KS in the absolute minimum requirements, your computer needs to have the following installed:

System	Framework	Terminal
Supported distros	.NET 8.0	Konsole, GNOME Terminal, etc.

You can consult the required dependencies here:

Dependency Information

Installation

There are several ways to install Nitrocid KS on Linux systems.

Method 1: Manual unpack

If you like to manually unpack the Nitrocid KS packages, follow these steps:

1. Ensure that you have all the required software installed

2. Download the latest release ZIP file from this page.
3. Unpack the ZIP archive to any folder of your choice

4. Open your favorite terminal emulator, like Konsole, and change the working directory to a folder containing the Nitrocid KS executable

5. Execute dotnet Nitrocid.dll to start the kernel

Method 2: Ubuntu PPA

This only applies to Ubuntu and its derivatives. However, we only support the vanilla Ubuntu distribution. Don't try this method on Debian.

If you're running Ubuntu, you can install Nitrocid KS using the Ubuntu PPA. Just follow these steps:

1. Open your terminal emulator and execute the following:

   • sudo add-apt-repository ppa:eofla/nitrocid

   • sudo apt update

2. Install the nitrocid package and follow the instructions (appending the -XX suffix to indicate the third mod API version part, such as 27)

   • sudo apt install nitrocid-27

3. Start ks (appending the same suffix above, like ks-27), or use your app drawer to find Nitrocid KS corresponding to your installed mod API version

You can choose between the version series that you want to upgrade in the output of the apt command when it prompts you to select one of them, as nitrocid is a virtual package.

Method 3: Arch Linux AUR

This only applies to vanilla Arch Linux. We don't officially support Arch's derivatives, such as Manjaro and EndeavourOS.

If you're running Arch, you can install Nitrocid KS using the Arch Linux AUR. Just follow these steps:

1. Open your terminal emulator and install your preferred AUR helper. Further steps assume that you have Yay installed.
2. Install the nitrocid-27 package and follow the instructions (appending the -XX suffix to indicate the third mod API version part, such as 27)

   • yay -Sy nitrocid-27

3. Start ks (appending the same suffix above, like ks-27), or use your app drawer to find Nitrocid KS corresponding to your installed mod API version

You can't install the release version and the cutting-edge (those with the -git suffix) version at the same time, since files conflict.

Bleeding-edge

Bleeding-edge builds usually come from building the development branch of the kernel, and they usually contain bugs and other untested features.

If you're a tester to such software, please follow the steps on your Linux machine. Please be sure that you're signed in to your GitHub account.

1. Open the canary release preparation workflow
2. Select the most recent build

3. Scroll down to Artifacts and click on the nks-build button to download the ZIP file.

4. Extract the file. Be sure that you have the latest version of 7-Zip or your favorite archive manager installed.

5. Open your favorite terminal emulator, like Konsole, and change the working directory to a folder containing the Nitrocid KS executable

6. Execute dotnet Nitrocid.dll to start the kernel

For Arch users, just follow the above steps, but install the -git suffix package like this:

• yay -Sy nitrocid-27-git

You don't need to sign in to your GitHub account in this case.