> For the complete documentation index, see [llms.txt](https://aptivi.gitbook.io/aptivi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aptivi.gitbook.io/aptivi/nitrocid-ks-v0.2.1-rolling-manual/installation-and-maintenance/installing-the-kernel/freebsd.md).

# FreeBSD

How to install Nitrocid KS on FreeBSD

Installing Nitrocid KS on FreeBSD is pretty easy. Before performing the installation, your FreeBSD system must meet the following requirements:

{% hint style="info" %}
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.
{% endhint %}

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

| System                 | Framework                                                                     | Terminal                      |
| ---------------------- | ----------------------------------------------------------------------------- | ----------------------------- |
| FreeBSD 15.0 or higher | [.NET 10.0](https://github.com/sec/dotnet-core-freebsd-source-build/releases) | Konsole, GNOME Terminal, etc. |

***

## <mark style="color:$primary;">Installation</mark>

There is one way to install Nitrocid KS on FreeBSD systems. Follow these steps to get started:

{% stepper %}
{% step %}

### <mark style="color:$primary;">Check your dependencies</mark>

Ensure that you have all the required software installed
{% endstep %}

{% step %}

### <mark style="color:$primary;">Download the latest ZIP</mark>

Download the latest release ZIP file from [this page](https://github.com/Aptivi/Kernel-Simulator/releases).
{% endstep %}

{% step %}

### <mark style="color:$primary;">Extract the archive</mark>

Unpack the ZIP archive to any folder of your choice
{% endstep %}

{% step %}

### <mark style="color:$primary;">Open the terminal emulator</mark>

Open your favorite terminal emulator, like Konsole, and change the working directory to a folder containing the Nitrocid KS executable
{% endstep %}

{% step %}

### <mark style="color:$primary;">Execute Nitrocid on your terminal</mark>

Execute `dotnet Nitrocid.dll` to start the kernel
{% endstep %}
{% endstepper %}

***

## <mark style="color:$primary;">Upgrade</mark>

The only way to upgrade Nitrocid in FreeBSD is to unpack the updated files manually. To upgrade, follow these steps:

{% stepper %}
{% step %}

### <mark style="color:$primary;">Download the latest ZIP</mark>

Download the latest release ZIP file from [this page](https://github.com/Aptivi/Kernel-Simulator/releases).
{% endstep %}

{% step %}

### <mark style="color:$primary;">Extract the archive</mark>

Unpack the ZIP archive to any folder of your choice
{% endstep %}

{% step %}

### <mark style="color:$primary;">Open the terminal emulator</mark>

Open your favorite terminal emulator, like Konsole, and change the working directory to a folder containing the Nitrocid KS executable
{% endstep %}

{% step %}

### <mark style="color:$primary;">Execute Nitrocid on your terminal</mark>

Execute `dotnet Nitrocid.dll` to start the kernel
{% endstep %}
{% endstepper %}