Entering or updating your license key

·

Your install stores one license key. There are two supported ways to set it: the setup wizard and the LICENSE_KEY environment variable. After it is set, an admin can re-verify it at any time with the Check now button on the license banner.

Setting the key during setup

The first-run setup wizard has a License field. It is optional — you can add the key later — but entering it here primes the status banner immediately.

  1. Open your new install; the setup wizard appears.
  2. Create the super admin and (optionally) set the base URL and company name.
  3. Paste your license key into the License key field.
  4. Finish setup. The app runs an initial verification right away so the banner reflects real status.

Seeding the key from the environment

If you set LICENSE_KEY in your Docker environment (for example in .env.docker), the wizard pre-fills the field with that value:

LICENSE_KEY=XXXX-XXXX-XXXX-XXXX

Refreshing or replacing the key

The license key is an install setting that is established at setup; there is no separate edit field in the general settings page. To force a fresh verification of the current key, use the banner:

  1. As an admin, locate the license banner (shown when there is a status to report).
  2. Click Check now. The app phones home synchronously (up to about 10 seconds if the server is slow) and updates the cached status.

If you need to change the key value itself, contact SummitPSA — updating the stored key is handled outside the everyday settings UI.

Was this article helpful?
Still need help? Contact SummitPSA support.