Entering and updating your license key

When you start your Tonic instance for the first time, you must provide your license key in order to activate Tonic.
You also update the license key when it expires or when you upgrade to a new license tier.

Activating a new Tonic instance

On a new instance of Tonic, to provide the Tonic license key and activate Tonic:
  1. 1.
    On the Welcome to Tonic panel, click Get Started.
  2. 2.
    On the Input License Key panel, in the License Key text area, paste your license key.
  3. 3.
    Click Activate.
Tonic verifies the license key. If the license key is valid, the Tonic login screen is displayed.

Updating a license key

When your license key expires, Tonic displays a banner across the top of the application. The banner contains a message to indicate that the license is expired.
For admin users, the expired license banner contains an Update Tonic License button.
The Update Tonic License button also displays on the System Status tab of the Admin Panel. You can use this option to update an expired license key or to provide a new key when you upgrade to a higher license tier.
System Status tab on Admin Panel with Update License Key option
You obtain your updated license key from Tonic. To update the license key:
  1. 1.
    Click Update Tonic License.
  2. 2.
    On the Update License Key panel, in the License Key text area, paste the new license key.
  3. 3.
    Click Update.
Tonic verifies the license key. If the license is valid, the license key is updated, and the expired license banner is removed.

Using the TONIC_LICENSE environment variable (for instances without admin users)

The Admin Panel option to update the license key is only available to admin users. All self-hosted instances should have at least one admin user.
If your instance does not have an admin user, then you can set the Tonic license key as the value of the TONIC_LICENSE environment variable.
If your instance has an admin user, then Tonic ignores the TONIC_LICENSE environment variable. You must use the Admin Panel to update the license.