Skip to content
LogScale Self-Hosted
This is an archived version of the documentation downloaded from LogScale Documentation Archives. Up to date documentation, and documentation for later versions, is available on LogScale Documentation

## License Installation

##### Security Requirements and Controls

- `View usage` permission

The documentation covers the process of installing and managing license keys in LogScale self-hosted environments, including methods for installation through both the Administration UI and API calls. The guide explains license updating procedures, handling expired licenses, and important considerations for maintaining license functionality, such as the 30-day expiration warning and restrictions that apply when licenses expire.

Once you've purchased a license for running LogScale self-hosted, you will need to install your license key.

You can install a key either through the `Administration` page within the user interface, or through an API call. If you're running LogScale in a cluster, you only have to add the key on a single node; it will be automatically propagated to all cluster nodes.

### Managing a License

From the account menu in the top right corner of the UI select `Administration` → License. Paste in the license key. Extra line breaks and white spaces are ignored.

### Using the API

Here is an example of updating the license key using CURL:

ini

    $ LICENSE_KEY="....."
    $ TOKEN=`cat /data/humio-data/local-admin-token.txt`
    $ curl -v -X POST -H "Authorization: Bearer $TOKEN" \
      -H 'Content-Type: application/json' \
      -d "{ \"query\": \"mutation { updateLicenseKey(license: \\\"$LICENSE_KEY\\\") { expiresAt } }\" }" \
     $YOUR_LOGSCALE_URL/graphql

This will return status 200 and the date your license expires.

### Updating a License

To update an existing license, update the license using the UI or API with the new license key.

Updating a license does not require a restart or reboot.

### Expired Licenses

The LogScale user interface will warn you 30 days before the license expires. The license is updated using the updateLicenseKey() GraphQL mutation. No restart is required for replacing/updating the license key.

If the LogScale Operator is used, ensure that the Kubernetes secret containing the license key is also updated otherwise anything that has been added in the UI or GraphQL will be overwritten.

If your license runs out, LogScale will continue accepting ingest data while your license is renewed — but the search interval will be restricted.

You can continue to send data, create repositories, dashboards and parsers. However the search interval is limited to 1 hour, alerts and scheduled searches will not run.

#### Enter search term