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.
PRO tariff and smart-fast
The router model copula-smart-fast is available on any tariff of the PRO family — that is, any tariff whose code starts with pro (pro, pro_x1, pro_x5, pro_x10, and future pro* codes). PRO is currently assigned on request — message @njg_ss in Telegram.
Calls to copula-smart-fast from a license on any tariff outside the PRO family fail with a terminal HTTP 403 from the router (error code copula_model_not_allowed). The backend treats this error as non-retryable: no retries and no automatic fallback to another model.
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.