Customer wiki

Licensing

Generated 2026-09-05 · committed product evidence baseline 28605da

Cosmik Streamer needs a valid licence before it turns video on. The licence check happens on the Streamer itself, so activation does not require a separate activation website or an internet connection on the device.

Current activation model: a new licence is issued without a Raspberry Pi Board ID. The first valid activation binds it to that Streamer and saves the binding locally. The older Board-ID-before-purchase process is no longer the current design.

Activate in the Console

  1. Open the Console and sign in as the owner.
  2. Open Licence from the menu.
  3. Choose the supplied cosmik-licence.key file, or paste the key.
  4. Tap Activate video.

The first successful activation binds that licence to this Raspberry Pi, stores the activation record on the card, and starts the admitted video features. Later checks use that local record. The status identifies the licence by its unique licence number rather than a customer name.

Keep a separate copy of the key. Re-flashing the card removes its installed copy and local activation record. Applying the original key again on the same Raspberry Pi restores the licence.

Activate from the SD card

  1. Turn the Streamer off and remove its microSD card.
  2. Open the small boot partition on a Windows or Mac computer.
  3. Copy the key to the top level and name it exactly cosmik-licence.key.
  4. Eject the card safely, return it to the Streamer, and power on.

A valid boot-partition key is imported and activated by the same local verification path.

If the key is rejected

  • Use the original complete key file rather than copying only part of its text.
  • A licence already activated on a different Raspberry Pi is refused.
  • A bad replacement key is checked before the existing working key is changed.
  • The Licence, Network, and System pages remain available so the owner can recover.
Replacement boundary: the purchase includes one replacement transfer, but the self-service redemption process is not built yet — contact support and a person will handle it.

Source: /docs/licensing.md