License NGINX Controller
This topic explains how to upload and manage licenses for NGINX Controller.
NGINX Controller licenses can be either connected or disconnected licenses:
- A connected license sends telemetry data to F5, which enables pricing based on usage. When adding a connected license, you must provide a customer Association Token, which you can get from the MyF5 Customer Portal.
- A disconnected license doesn’t send telemetry data to F5. To add a disconnected license, you can upload the license file using the NGINX Controller web interface or the NGINX Controller API.
To access your license, get your Customer Access Token, or sign up for a trial license, visit the MyF5 Customer Portal.
To add or update a license for NGINX Controller, take the following steps:
In the Upload a license section of the page, select an upload option:
- Upload license file – Locate and select your license file in the file explorer.
- Paste your Association Token or license file – Paste your customer Association Token or the contents of your NGINX Controller license file. These are available on the MyF5 Customer Portal.
Select Save license.
To add a license using the NGINX Controller REST API, send a PUT request to the
/platform/licenseendpoint. Provide your CAT or NGINX Controller license as a base64-encoded string in the JSON request body.
To view the details for your NGINX Controller license, take the following steps:
- On the NGINX Controller menu, select Platform > License > Controller License.
- On the Licenses page, you can view the details for the applied licenses, including license limitations, status, and the expiration date.
To view the details for your license(s) using the NGINX Controller REST API, send a GET request to the
To delete a license using the NGINX Controller REST API, send a DELETE request to the
When you license NGINX Controller, you have full access to all of the features included in the license.
If you haven’t licensed NGINX Controller, or if your license has expired, you can still access the following restricted set of features using the NGINX Controller REST API:
- Log in and out of NGINX Controller
- Manage licenses
- Manage users
- Manage user groups
- Manage roles
- Manage integration accounts
- Manage support bundles
- Manage backups
- View alerts
Workloads are backend or upstream objects to NGINX Controller that receive traffic, such as applications and containers. Workloads are quantified for licensing purposes using a combination of location and server specifics (for example, unique IP address or unique instance ID).
Aggregate data is represented by the total volume of bytes in/out per hour for all of the data planes managed by NGINX Controller.
To verify your license is compliant, check for the following:
Make sure your usage is within the capacity that your license allows. Refer to the View License Details section for instructions.
Ensure your license has not expired.
If you are using an Association Token, make sure to allow incoming and outgoing connections on port 443 TCP. If you’re running NGINX Controller v3.15 or earlier, also enable incoming and outgoing connections on port 8883 TCP. These ports are used for validating the entitlements for your license. Refer to the NGINX Controller Technical Specifications Guide for these and other firewall requirements.
If NGINX Controller appears to be unlicensed after a version upgrade, try the following options to resolve the issue.
This documentation applies to the following versions of NGINX Controller Documentation: 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9, 3.10, 3.11, 3.12, 3.13, 3.14, 3.15 and 3.16.