Skip to content

License Configuration

TIP

The license configuration applies to the EMQX Enterprise edition only.

You can update your license file and configure the settings for the license connection quota usage the configuration file emqx.conf. After the configuration, you can run emqx ctl license reload in EMQX command line tool to reload the license.

Below is an example of configuring the EMQX Enterprise license settings:

bash
license {
  key  =  "MjIwMTExCjAKMTAKRXZhbHVhdGlvbgpjb250YWN0QGVtcXguaW8KZGVmYXVsdAoyMDIzMDEwOQoxODI1CjEwMAo=.MEUCIG62t8W15g05f1cKx3tA3YgJoR0dmyHOPCdbUxBGxgKKAiEAhHKh8dUwhU+OxNEaOn8mgRDtiT3R8RZooqy6dEsOmDI="
  connection_low_watermark  =  "60%"
  connection_high_watermark  =  "80%"
}

Where,

  • key is the field contains a license key encoded in base64 format.
  • connection_low_watermark is to set a threshold below which license connection quota usage alarms are deactivated; default: "75%"
  • connection_high_watermark is to set a threshold above which license connection quota usage alarms are activated; default: "80%"

After execution, you can run emqx ctl license info to confirm that the new license file has taken effect.

TIP

You can also configure the license file through the EMQX Dashboard. For how to configure the license via Dashboard, see Work with License. Once you configured these items with the Dashboard, your settings will override the same configuration items in emqx.conf.

TIP

EMQX offers more configuration items to serve customized needs better. For details, see the EMQX Open Source Configuration Manual and EMQX Enterprise Configuration Manual for Enterprise.