Skip to content
imaged

Licenses & renewals

App identity, integrators, offline use, and license delivery.

Every app that runs Slab needs a runtime license. Your app passes the signed license string to Slab, which checks it on the device. No activation server or end-user account is needed, and installations are unlimited.

These instructions cover the app-ID licenses used by the Slab 0.1 SDK. Older platform-bound licenses remain valid with their original restrictions. Update an older SDK before attaching an app-ID license.

During the console rollout, an app page may still ask for platform and signing details. Licenses issued through that flow retain those bindings. The app-ID-only flow below applies when your app page offers a primary ID and variants. Follow the fields shown in your console; existing platform-bound licenses remain supported by the new SDK.

One product, one license

Register a primary app ID in the customer console. A license can contain that ID and up to 15 exact variants of the same product: debug builds, staging builds, flavors and extensions. It does not cover 16 unrelated apps.

Example Use
com.acme.reader Primary app ID
com.acme.reader.debug Debug build
com.acme.reader.staging Staging build
com.acme.reader.widget Widget that loads Slab

Self-service variants must start with the complete primary ID followed by a dot. Sharing a company prefix is not enough: com.acme.store is another product, not a variant of com.acme.reader. If the same product uses a different ID on another platform, request an admin-reviewed exception for that exact ID.

The primary ID locks after the first license is issued, including after that license expires. You can edit the variant list. Each ID must be listed explicitly; there are no wildcards.

Which app ID to enter

Platform Identity checked by Slab
iOS / iPadOS Bundle identifier of the app or extension loading Slab
Android applicationId, including any applicationIdSuffix
macOS Bundle identifier of the host app or executable

The same license file works across iOS, Android and macOS for the IDs it lists, and with the slab-load tool on your Mac. New licenses do not require an Apple App ID prefix, Keychain group or Android signing-certificate digest.

Call Slab.bind(context) on Android before attaching the license. For a macOS command-line executable, embed an Info.plist with your licensed CFBundleIdentifier; see C setup. A terminal process without an app identity cannot use an app license merely by loading the library.

IDs are compared ignoring ASCII case. Each has at least two dot-separated parts containing letters, digits, underscores or hyphens, with no empty parts. The maximum is 255 bytes per ID and 416 bytes for the complete comma-separated list. Placeholder and reserved platform IDs are refused.

An app ID belongs to one account. Conflicting claims go to the admin review queue; registration does not automatically transfer ownership.

Trial and paid licenses

  • The free trial lasts 30 days, once per account. An administrator can extend it.
  • Adding or removing variants does not extend the trial or a paid license.
  • Paid terms are confirmed with your invoice. Every license has an expiry date.
  • At expiry, new runs stop, including for already-loaded models. Work already running finishes.

Register your primary app ID, then copy or download the license from its console page. Paid purchases and renewals are reviewed by our team. We send an invoice for payment by bank wire. Manage your request and copy or download your issued license from the console.

Integrators

An integrator manages licenses for the products it delivers to clients. Include the Slab license inside your own license delivery or app configuration; your customer does not need a Slab account. Your parent product may impose its own limits, while Slab checks its runtime license and app ID.

In the app

  1. On Android, bind Slab to the app once at startup.
  2. Load the license string from an app resource, your remote configuration or your own server. Its signature establishes validity; it is not a signing secret.
  3. Attach it to the Config before opening models. Sessions created from that Config receive it.
  4. For renewal, attach the new string to the Config for future sessions and to existing sessions to renew them without reloading models.

Slab does not fetch or schedule licenses. A renewal without an app update is possible when your app already retrieves licenses remotely. If the license is bundled in the app, deliver an updated bundle.

Editing variants reissues an active license with the same kind and expiry. Download and deliver the new string. Previously issued strings remain valid until their own expiry; removing a variant does not revoke old strings. If a replacement string is rejected, the previous attached license stays in place until it expires.

Troubleshooting

Message What to do
Runtime license identity or client scope does not match Add the app's exact ID to its product's license, then deliver the new string.
Application identity is unavailable On Android call Slab.bind(context) first. On macOS provide a bundle identifier for the host executable.
Runtime license does not cover this platform An older platform-bound license was used on another platform. Obtain a current app-ID license.
Invalid runtime license format Check that the complete string was copied, and update SDKs built before app-ID licensing.
Runtime license has expired / Runtime license is not yet valid Renew or check the device clock.
Unknown runtime license issuer or key purpose Check the SDK and license are from compatible releases; test-key licenses are not accepted by release SDKs.

Other license errors can indicate a missing license, invalid signature, unsupported feature or a runtime older than the license's minimum release. Reading model information and preparing images do not require a runtime license.

Protected models are separate

A runtime license permits Slab execution. Encrypting a model and unlocking it with a key or model token is a separate mechanism controlled by the model's owner. Protected packs run on CPU and GPU, not on the Neural Engine or Hexagon NPU.