# Updating Software & Licenses

Follow this guide to update system software and packages

# Installing a License on your SKAARHOJ Controller

#### If the controller is online

If your controller is online and has internet access through its network, it will automatically detect and apply any assigned licenses. You can confirm that your controller is connected to the internet by looking for a green icon in the upper right corner next to the SKAARHOJ logo.

![Screenshot 2025-06-23 at 2.29.39 PM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2025-06/scaled-1680-/screenshot-2025-06-23-at-2-29-39-pm.png)

Please navigate to the Settings tab and refresh the page once or twice. After doing so, you should see the license displayed in the license drop-down menu.

[![image.png](https://wiki.skaarhoj.com/uploads/images/gallery/2023-11/scaled-1680-/xlsimage.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2023-11/xlsimage.png)

#### If the controller is offline

You can obtain a license in the form of a file, which you can upload via the Packages tab. If you haven't received your license file and need it for installation, contact <support@skaarhoj.com> with the panel's serial number for assistance.

To upload a license file, use the Upload button located at the bottom of the Packages tab, similar to how you would upload a software update on offline controllers.

[![image.png](https://wiki.skaarhoj.com/uploads/images/gallery/2023-11/scaled-1680-/flmimage.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2023-11/flmimage.png)

# Rolling Back Updates

**Online Method**

Rolling back firmware package updates can be down via the Packages page if your device has connection to the internet.

<p class="callout info">It is not possible to roll back SkaarOS. </p>

In the drop down next to the device core package you can select from previously released versions.

[![Screenshot 2023-07-13 at 1.10.01 PM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/scaled-1680-/screenshot-2023-07-13-at-1-10-01-pm.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/screenshot-2023-07-13-at-1-10-01-pm.png)

Once selected, click Install

[![Screenshot 2023-07-13 at 1.14.24 PM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/scaled-1680-/screenshot-2023-07-13-at-1-14-24-pm.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/screenshot-2023-07-13-at-1-14-24-pm.png)

To select from a previous pre-released version of the package, in the upper right corner, enable the Show pre-release toggle.

[![Screenshot 2023-07-13 at 1.10.31 PM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/scaled-1680-/screenshot-2023-07-13-at-1-10-31-pm.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/screenshot-2023-07-13-at-1-10-31-pm.png)

**Offline Method**

If internet connection is not an option, it is possible to download the latest stable release and prerelease version from our site [devices.skaarhoj.com](https://wiki.skaarhoj.com/devices.skaarhoj.com)

Navigate to the device core package you need based on the device you are trying to control. Then select either the Pre or Stable version.

<p class="callout info">Main Blue Pill firmware packages and the operating system can be found under Other Packages:  
[https://devices.skaarhoj.com/otherpackages](https://devices.skaarhoj.com/otherpackages)  
</p>

[![Screenshot 2023-07-13 at 1.21.13 PM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/scaled-1680-/screenshot-2023-07-13-at-1-21-13-pm.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/screenshot-2023-07-13-at-1-21-13-pm.png)

For some select packages it is possible to download more versions offline. Packages with that option will have an All Versions option.

[![Screenshot 2023-07-13 at 1.10.53 PM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/scaled-1680-/screenshot-2023-07-13-at-1-10-53-pm.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/screenshot-2023-07-13-at-1-10-53-pm.png)

Select the desired version then download.

[![Screenshot 2023-07-13 at 1.11.39 PM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/scaled-1680-/screenshot-2023-07-13-at-1-11-39-pm.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/screenshot-2023-07-13-at-1-11-39-pm.png)

The .ipks package can then be uploaded to the Blue Pill device from the bottom of the Packages page.

[![Screenshot 2023-07-13 at 1.25.27 PM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/scaled-1680-/screenshot-2023-07-13-at-1-25-27-pm.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2023-07/screenshot-2023-07-13-at-1-25-27-pm.png)

# Update Software

Follow this guide to update the Blue Pill software.

<p class="callout info">If the Blue Pill device does not have access to the internet, the option to download the core via the web browser should be available. </p>

If Blue Pill is unable to communicate with our server, please read the troubleshooting chapter:  
[https://wiki.skaarhoj.com/books/blue-pill-reactor/page/unable-to-update-device-corespackagesos](https://wiki.skaarhoj.com/books/blue-pill-reactor/page/unable-to-update-device-corespackagesos)

#### **Update Operating Packages**

Open the 'Packages' page.  
Locate the 4 lines: 'hardware-manager' / 'system-manager' / 'reactor' / 'SkaarOS\*  
If a green 'Update' button is displayed to the right of any of them, this means there is an update available.  
If so, please click the 'Update' button for each of them or the Update All button   
( After the update, if they do not display 'Running' you must click the 'Stopped' text and select 'Restart'. )

<p class="callout info">System Manager and SkaarOS do not update via the Update All option. These need to be updated individually. </p>

<p class="callout info">It is recommended to update SkaarOS last as it requires a reboot. </p>

![Screenshot 2025-06-24 at 14.58.31.png](https://wiki.skaarhoj.com/uploads/images/gallery/2025-06/scaled-1680-/screenshot-2025-06-24-at-14-58-31.png)

#### **Update Pre-Release Versions**

Show Pre-Release must be enabled to see pre-release versions on the Packages page.  
This is done by clicking on the toggle at the top of the Packages page.  
( This only affect the current web browser in the current session. It will be off next time you log in. )

[![Show PreRelease.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-08/scaled-1680-/show-prerelease.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-08/show-prerelease.png)

#### **White list our server URL's**

In order to download software, Blue Pill must have network access to these 3 domains:

• [https://pkg.skaarhoj.com](https://pkg.skaarhoj.com)  
• [https://init.skaarhoj.com](https://init.skaarhoj.com)  
• [https://lb1.skaarhoj.com](https://lb1.skaarhoj.com)

# Uploading Device Cores/Packages/OS from Offline

<div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk-all-device-cores%2C-pa">All device cores, packages, and SkaarOS can be loaded from offline onto the Blue Pill. The individual package files are all available at [https://devices.skaarhoj.com/](https://devices.skaarhoj.com/) and are loaded via your Blue Pill device's web interface. </div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk-">  
</div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk-1.-for-connected-dev">1. For connected device related device cores, on [https://devices.skaarhoj.com/](https://devices.skaarhoj.com/), navigate to the device you are trying to control. Click on **STABLE** or **PRE**  will download the latest stable or prerelease version, as indicated in the version number within the parenthesis. </div>![Screenshot 2024-02-06 at 11.35.31 AM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2024-02/scaled-1680-/screenshot-2024-02-06-at-11-35-31-am.png)

<div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk-2.-to-download-the-l"></div><div class="ql-block align-left" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk-3.-to-download-the-c">2. To download the core packages and OS that make the Blue Pill work, select **Other Packages** at the top of the page. </div>![Screenshot 2024-02-06 at 11.38.43 AM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2024-02/scaled-1680-/screenshot-2024-02-06-at-11-38-43-am.png)

<div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk--4">  
</div><div class="ql-block align-left" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk-both-the-latest-prer">Both the latest prerelease and stable release are available as options. </div>![Screenshot 2024-02-06 at 11.39.49 AM.png](https://wiki.skaarhoj.com/uploads/images/gallery/2024-02/scaled-1680-/screenshot-2024-02-06-at-11-39-49-am.png)

<div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk--6">  
</div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk-the-specific-version">The specific version will be in the file name. </div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk--7">[![version name.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-07/scaled-1680-/version-name.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-07/version-name.png)</div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk--8">  
</div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk-4.-all-of-the-packag">3. All of the packages are loaded onto the Blue Pill or Blue Pill Inside device via the Packages page. </div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk--9">[![packages page redo.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-07/scaled-1680-/packages-page-redo.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-07/packages-page-redo.png)</div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk-at-the-very-bottom-i">At the very bottom is an option to **Upload and Install Package**</div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk--10">**[![manually load.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-07/scaled-1680-/manually-load.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-07/manually-load.png)**</div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk-then-select-the-pack">Then select the package from your computer for uploading. All packages will be **.ipks** files except for SkaarOS which will be a **.raucb** file. If the file names do not have the proper file type extension please and therefor fail to load, please contact <support@skaarhoj.com> </div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk--11">[![select package.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-07/scaled-1680-/select-package.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-07/select-package.png)</div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk--12">[![confirm upload.png](https://wiki.skaarhoj.com/uploads/images/gallery/2022-07/scaled-1680-/confirm-upload.png)](https://wiki.skaarhoj.com/uploads/images/gallery/2022-07/confirm-upload.png)</div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk--13"></div><div class="ql-block" data-block-id="block-edf08169-9626-4541-96d6-89d8c19d70c3" id="bkmrk--14"></div><p class="callout info">Please note: Blue Pill devices running Skaar OS v0.11 or earlier and/or init v0.1.23 or earlier may have trouble loading packages from offline. Please contact support if you experience any difficulty. </p>