Universal Builds

Starting from ReadonlyREST 1.44.0, our Kibana plugins are released in a unified format.

What is a universal build?

A universal build is a single Kibana plugin deliverable that is compatible with a given Kibana version.

If not activated, a universal build will behave exactly like the old "Free" edition.

Some activation keys can be used to unlock PRO and Enterprise features. If a trial activation key is used, these features availability will be limited in time.

How to install a universal build?

The same way it worked before, just download it the same way you used to, from the Downloads page and install it as usual.

How to activate PRO/Enterprise features a universal build?

Check out our new customer portal. If your email is associated to a customer contract with a valid ongoing subscription, you will be able to obtain an activation key. Otherwise, you will be able to obtain a trial activation key.

There are a few ways to pass the activation key to Kibana. Regardless of which one you use, the result will be that Kibana will save the activation key to an encrypted Elasticsearch index, so other Kibana instances will pick up the new activation key.

Via Environmental variable

This method is useful for Docker deployments. Just set the ROR_ACTIVATION_KEY environment variable to the activation key you obtained from the customer portal.

$ export ROR_ACTIVATION_KEY=<your activation key>
$ bin/kibana 

Via our plugin license API

Once Kibana is up and running, you can send a HTTP request to Kibana.

POST http://<kibana-host-with-ror>:5601/api/ror/license?overwrite=true
{
  "token": "your activation key" 
}

Via ROR_ACTIVATION_KEY.txt file

The universal build is a zip archive. You can add a small text file with your activation key to this archive before installing it, so it will be picked up automatically at the first boot.

  • The text file should be called ROR_ACTIVATION_KEY.txt

  • It should contain your secret activation key string (no spaces, no new lines)

  • It should be added to the root directory of the plugin zip archive

Now install the plugin file, start Kibana, and the activation key should be loaded.

Interactive activation key management

This method is useful for manual deployments.

  1. Start Kibana in the default "Free" edition mode

  2. Login in Kibana as an admin or unrestricted kibana access

  3. Toggle the ROR Menu on the top right

  4. Click on the "Free" text tag

  1. Enter the activation key you obtained from the customer portal in the license management UI

Change Activation key retrieval mode via kibana.yml

In the kibana.yml configuration file, you have the option to specify the mode for retrieving activation keys. Setting this parameter effectively means that all other activation key retrieval methods will be disregarded.

Default behaviour

If there is no kibana.yml license config provided or activationKeyRetrievalMode: "all" defined:

readonlyrest_kbn:
    license:
        activationKeyRetrievalMode: "all" # "file" | "env" | "all" | "none"

Then the order of activation key validation is:

  1. Retrieve from index

  2. ENV variable

  3. File

  4. Default Activation key (which means free license) If AK is found in any of the aforementioned locations, the verification process will be halted.

From environment variable retrieval option

you can add to kibana.yml:

readonlyrest_kbn:
    license:
        activationKeyRetrievalMode: "env" # "file" | "env" | "all" | "none"

From a file retrieval option

you can add to kibana.yml:

readonlyrest_kbn:
    license:
        activationKeyRetrievalMode: "file" # "file" | "env" | "all" | "none"
        activationKeyFilePath: /tmp/activation.key

Last updated