Getting a license
A self-hosted Copula backend requires a license token. The token is issued in the Copula cabinet and also serves as the credential for the cabinet's LLM router.
Get the token
- Open the Copula cabinet at https://app.copul4.com and register an account.
- Generate a license in the cabinet.
- Copy the license token (an RS256-signed token).
You pass the token to the backend as the LICENSE_TOKEN environment variable — either in the provisioning wizard's License step or in the .env file of a manual installation. The same token doubles as the bearer token for the cabinet LLM router, which is the default model provider for new installs.
Tariffs and quotas
Available tariffs: base_x1, base_x5, base_x10, pro.
LLM usage is quota-limited in fixed UTC calendar windows:
- a five-hour window, and
- a weekly window (the week starts Monday 00:00 UTC).
When a quota is exhausted, the LLM router returns HTTP 429 with the error code copula_quota_exceeded. Wait for the window to reset or upgrade the tariff in the cabinet.
Expiration
Licenses currently expire after 30 days (hard-coded). When a license expires, renew or regenerate it in the cabinet at https://app.copul4.com and update LICENSE_TOKEN on the backend.