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

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

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

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. 

It is not possible to roll back SkaarOS. 

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

Once selected, click Install

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

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 

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. 

Main Blue Pill firmware packages and the operating system can be found under Other Packages:
https://devices.skaarhoj.com/otherpackages

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

Select the desired version then download. 

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

Update Software

Follow this guide to update the Blue Pill software.

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. 

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

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'. )

System Manager and SkaarOS do not update via the Update All option. These need to be updated individually. 

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

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://init.skaarhoj.com
https://lb1.skaarhoj.com


Uploading Device Cores/Packages/OS from Offline

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/ and are loaded via your Blue Pill device's web interface. 

1. For connected device related device cores, on 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. 

Screenshot 2024-02-06 at 11.35.31 AM.png

2. To download the core packages and OS that make the Blue Pill work, select Other Packages at the top of the page.  

Screenshot 2024-02-06 at 11.38.43 AM.png


Both the latest prerelease and stable release are available as options. 

Screenshot 2024-02-06 at 11.39.49 AM.png


The specific version will be in the file name. 
version name.png

3. All of the packages are loaded onto the Blue Pill or Blue Pill Inside device via the Packages page. 
packages page redo.png
At the very bottom is an option to Upload and Install Package
manually load.png
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 
select package.png
confirm upload.png

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.