WARNING: Version 5.1 of the Elastic Stack has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
You can update your license at runtime without shutting down your nodes. License updates take
effect immediately. The license is provided as a JSON file that you install with the
When Security is enabled, you need cluster admin privileges to install the license.
elastic user has the required privileges.
To update your license:
Send a request to the
licenseAPI and specify the file that contains your new license:
curl -XPUT -u elastic 'http://<host>:<port>/_xpack/license' -d @license.json
elasticis the built-in super user. The default password is
changeme. If you haven’t already, change the default password. Any user with cluster admin privileges can install the license.
<host>is the hostname of the Elasticsearch node (
localhostif executing locally)
<port>is the http port (defaults to
license.jsonis the license JSON file
If the license you are installing does not support all of the features available with your previous license, you will be notified in the response. To complete the license installation, you must resubmit the license update request and set the
trueto indicate that you are aware of the changes.
curl -XPUT -u elastic 'http://<host>:<port>/_xpack/license?acknowledge=true' -d @license.json