Prerequisites
Before activating a license, make sure you have:- A running self-hosted OpnForm installation
- A user account that is an admin of at least one workspace
- A self-hosted Enterprise license key
- Network access from your API container or server to the OpnForm license API
https://api.opnform.com.
Activate a license from the UI
License-related environment variables
Most installations can use the default license API settings. Override these variables only when instructed by OpnForm support or when you run a custom license API endpoint.| Variable | Description |
|---|---|
LICENSE_API_ENDPOINT | Backend license API endpoint. Defaults to https://api.opnform.com. |
LICENSE_CHECKOUT_SUCCESS_URL | Checkout success URL used when creating self-hosted Enterprise license checkout sessions. |
LICENSE_CHECKOUT_CANCEL_URL | Checkout cancellation URL used when creating self-hosted Enterprise license checkout sessions. |
LICENSE_PORTAL_RETURN_URL | Return URL used by the billing portal for self-hosted Enterprise licenses. |
NUXT_PUBLIC_LICENSE_API_ENDPOINT | Front-end license API endpoint used to start Enterprise license checkout. Defaults to https://api.opnform.com. |
Network requirements
The API validates the installed license with the configured license API endpoint. The instance sends its license key, instance identifier, and usage metadata needed to validate the license. OpnForm caches license checks. If the license API is temporarily unavailable after a successful check, the instance can enter a short grace state and continue using licensed features while it retries validation.License statuses
| Status | Meaning |
|---|---|
active | The license is valid and Enterprise features are enabled. |
grace | The last successful check is still within the grace window after a temporary license API failure. |
expired | The license is no longer active. Enterprise features are disabled until renewal or activation of a valid key. |
activation_limit_reached | The key is already activated on another self-hosted instance. Contact support to reset the activation. |
invalid | The key is missing, invalid, or could not be validated. |
Troubleshooting
The license key is invalid or expired
The license key is invalid or expired
Confirm that you copied the full key and that the license is active. If the key still fails, contact OpnForm support.
The activation limit was reached
The activation limit was reached
A self-hosted license key is tied to an instance activation. Contact support if you migrated servers or need the activation reset.
Enterprise features are still locked after activation
Enterprise features are still locked after activation
Refresh the page and sign in again. If features remain locked, confirm that the API can reach the configured
LICENSE_API_ENDPOINT, then recreate containers if you changed environment variables.The billing portal does not open
The billing portal does not open
Make sure a valid license key is installed and that the API can reach the license API endpoint.