License Management

Once you’ve purchased a license for running Humio self-hosted, you will need to install your license key. If you don’t have a license key, you can run Humio in Trial Mode and Humio will keep all of your data for when you install your license.

You can install a key either through the Administration interface from the user interface, or through an API call. If you’re running Humio in a cluster, you only have to add the 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:

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_HUMIO_URL/graphql

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

Expired Licenses

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

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