Docs
Powered by

License Activation

Some of the Bass OS builds do require licensing activation. After contacting us with your device serial numbers and purchasing a license, there are a few different ways it can be activated.

On builds that include BootSight (--bootsight, ro.bass.fleet_mgmt=bootsight), the on-device path is Settings → Device Status. Builds that use an MDM instead (--fleet-mgmt=mdm) will not show that entry. See Fleet Management.

Option A: On Device

Start off by going into Android Settings

Screenshot_20241107-131404_Settings
Screenshot_20241107-131404_Settings

Then scroll down to the Device Status option (if it is not showing, close Settings and re-open)

Screenshot_20241107-131417_Settings
Screenshot_20241107-131417_Settings

After selecting the Device Status activity, you can see your product serial number here. This is the serial number you will need to report to us with in order for us to register your device.

Screenshot_20241107-131424_Bootsight
Screenshot_20241107-131424_Bootsight

Once reported and license is purchased, you can click on the "Check Device Status" button to check it's activation status. Once activated, the screen will reflect the status by showing as "Licensed"

Option B: Using ADB

Connect to the device using ADB, and run the following command to collect its serial number:

adb shell getprop ro.bliss.serialnumber

Option C: Offline Activation (no internet)

Some builds are configured for offline licensing (persist.bass.bootsight.offline_licensing=1, produced by build.sh --bs-offline). These devices never contact the license server and send no telemetry. They are activated with a signed license file or an activation code instead.

Offline licenses are cryptographically signed and bound to each device's serial and SKU, so a code only activates the device it was issued for and cannot be reused on another device. If a licensed disk image is cloned to different hardware, it reverts to unlicensed on that hardware.

There are three ways to apply an offline license:

1. USB drive + Files app (no ADB, no network)

We provide a single license.pack file covering every serial you purchased. The same file can be placed on every device; each device automatically picks the entry that matches its own serial. Individual per-device <serial>.lic files are also accepted.

  1. Copy license.pack (or the device's .lic file) to a USB drive and plug it into the device.
  2. Either leave it on the drive, or use the Android Files app to copy it to the Download or Documents folder on the device.
  3. If it was copied to Download/Documents, the device picks it up automatically within a few seconds. If it is still on the USB drive, go to Settings → Device Status → Scan drives for license file; BootSight scans any connected USB drives (and the Download/Documents folders) and activates on the spot.

The screen shows as Licensed immediately, with no reboot needed. The license is copied to internal storage during activation, so the USB drive can be removed afterwards.

2. Drop the file with ADB (best for provisioning scripts)

Push the same pack into the BootSight data directory:

adb push license.pack /data/misc/bootsight/license.pack

The device picks up the file within a few seconds and shows as Licensed. Provisioning scripts or factory imaging can place the file at the same path.

3. Enter or scan an activation code

On the device, go to Settings → Device Status → Enter activation code. Then either:

  • Scan the QR label for that device with a USB barcode scanner (it types the code automatically), or
  • Type or paste the activation code issued for that device.

Once verified, the device shows as Licensed immediately.

To obtain offline licenses, gather your device serial numbers (Option A or B above) and send them to us with your purchase; we return a license.pack (and printable QR labels on request). See Fleet Management for bulk workflows.

License Payment

Single Device Licensing

We offer an easy method to purchase single device licenses through our website here: BassOS Single Device Licensing

Bulk Licensing

We require a licensing contract for any more than 10 licenses. Follow the steps above to gather the serial numbers required, and contact us at info@navotpala.tech with all the serial numbers you want to register. Once payment is confirmed, we will activate the license for each serial shared and send you a response when complete.

From there, you can manually navigate each device to Settings > Device Status & check license status from there, reboot each device, or use adb to reboot each device for it to confirm it's license status once it reconnects to the internet:

adb root
adb shell reboot -f

We also offer bulk license management through our Access Guard application which is available through contract only. For more info on that service, please contact us at [info@navotpala.tech](info@navotpala.tech?subject=Access Guard Licensing) and express your interest.