License Installation

Security Requirements and Controls

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 pages 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.

Expired Licenses

The LogScale user interface will warn you 30 days before the license expires.

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 hr, alerts and scheduled searches will not run.