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 key on a single node; it will be automatically propagated to all cluster nodes.
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.
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.
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.