---
description: This page talks about available methods of upgrading
---

# Upgrading the Kernel

{% hint style="warning" %}
#### Stop!

Before you can upgrade, you need to consider the following:

* Mods will need to be upgraded to the version that you're upgrading to.
* Configuration backups, including those that are created by your mods, will have to be created before each upgrade.

As for upgrading to 0.1.0, old configuration styles are no longer supported and are kept in your home directory for reference. However, starting from 0.1.0.5, you can migrate most of your old-style configuration (as early as 0.0.16.0 released on 2021) to 0.1.0 and later. See why [here](https://github.com/Aptivi-Stable-Docs/nks-manual-0.1.0-rtm/blob/main/installation-and-maintenance/upgrading-the-kernel/broken-reference/README.md).
{% endhint %}

Nitrocid KS can be upgraded in all supported platforms. However, some upgrades might break your mods and configuration files, so please be sure that you follow the compatibility notes which is linked below.

{% content-ref url="https://github.com/Aptivi-Stable-Docs/nks-manual-0.1.0-rtm/blob/main/installation-and-maintenance/upgrading-the-kernel/broken-reference/README.md" %}
[https://github.com/Aptivi-Stable-Docs/nks-manual-0.1.0-rtm/blob/main/installation-and-maintenance/upgrading-the-kernel/broken-reference/README.md](https://github.com/Aptivi-Stable-Docs/nks-manual-0.1.0-rtm/blob/main/installation-and-maintenance/upgrading-the-kernel/broken-reference/README.md)
{% endcontent-ref %}

Generally, Nitrocid KS can automatically download an update file and, if launched through the built-in launcher for Linux systems, installs the update itself. For Windows systems, it can be seamlessly updated if you installed Nitrocid through Chocolatey. For Ubuntu systems, Nitrocid PPA installs can also be updated through `apt upgrade`.

However, if this mechanism fails, you can rely on manually updating. Select your platform to get instructions.

{% content-ref url="upgrading-the-kernel/windows" %}
[windows](upgrading-the-kernel/windows)
{% endcontent-ref %}

{% content-ref url="upgrading-the-kernel/macos" %}
[macos](upgrading-the-kernel/macos)
{% endcontent-ref %}

{% content-ref url="upgrading-the-kernel/linux" %}
[linux](upgrading-the-kernel/linux)
{% endcontent-ref %}

{% content-ref url="upgrading-the-kernel/android" %}
[android](upgrading-the-kernel/android)
{% endcontent-ref %}
