Licensing

Scriptix On-Prem requires a valid license to operate. Without a license, the API returns 401 Unauthorized on all endpoints (except the health check).

License Types

Online License

Your Scriptix instance validates the license key with the licensing server at startup.

Requirements: Internet access to licensing.scriptix.app

Setup: Add your license key to the configuration file:

licensing:
  license_key: "your-license-key-here"

Offline License (Air-Gapped)

A signed license file that is verified locally using RSA cryptography. No internet required.

You receive two files from Scriptix:

• license.json — your signed license with limits
• license_key.pub — the public key used to verify the signature

Setup: Place both files in your config directory and reference them:

licensing:
  license_file: /etc/config/license.json
  public_key_file: /etc/config/license_key.pub

Requesting a License

Via the Admin UI

1. Log in to Scriptix as a system administrator
2. Navigate to Settings > License
3. Click Request License
4. Fill in:
   • Organization name: your company name
   • Expected users: how many users will use the platform
   • Expected organizations: how many separate teams/departments
5. Submit the request — this sends a license request to Scriptix

You will receive your license file (offline) or license key (online) via email, typically within one business day.

Via Email

Contact info@scriptix.io with:

• Company name
• Deployment type: online or offline (air-gapped)
• Number of users
• Number of organizations
• Desired concurrent processing capacity

License Limits

Your license controls:

Limit	Description
org_limit	Maximum number of organizations you can create
user_limit	Maximum number of active users across all organizations
max_processing	Maximum concurrent transcription jobs

When a limit is reached:

• Creating new organizations or inviting users returns an error
• Existing users and transcriptions continue to work
• Queued transcription jobs wait until a slot is available

Checking License Status

Via the Admin UI

Navigate to Settings > License to see:

• License validity
• Current usage vs. limits
• Expiration date (if applicable)

License Expiration

• Licenses can be issued with or without an expiration date
• When a license expires, the API starts returning 401 Unauthorized
• Existing data is preserved — nothing is deleted
• Contact Scriptix to renew your license

Renewing or Upgrading

To renew or change your license limits:

1. Contact Scriptix with your current license details
2. Receive an updated license.json (offline) or new license key (online)
3. Replace the license file or update the key in your configuration
4. Restart the API service:

docker compose -f docker-compose.onprem.yml --env-file .env.onprem restart api

5. Verify at Settings > License or via the API endpoint