Manage your InfluxDB 3 Enterprise license
InfluxDB 3 Enterprise licenses authorize the use of the InfluxDB 3 Enterprise software and apply to a single cluster. Licenses are primarily based on the number of CPUs InfluxDB can use, but there are other limitations depending on the license type.
License feature comparison
The following InfluxDB 3 Enterprise license types are available:
- Trial: 30-day trial license with full access to InfluxDB 3 Enterprise capabilities.
- At-Home: For at-home hobbyist use with limited access to InfluxDB 3 Enterprise capabilities.
- Commercial: Commercial license with full access to InfluxDB 3 Enterprise capabilities.
Features | Trial | At-Home | Commercial |
---|---|---|---|
CPU Core Limit | 256 | 2 | Per contract |
Expiration | 30 days | Never | Per contract |
Multi-node | |||
Commercial use |
All other InfluxDB 3 Enterprise features are available to all licenses.
CPU limit
Each InfluxDB 3 Enterprise license limits the number of CPUs InfluxDB can use. The CPU limit is per cluster, not per machine. A cluster may consist of multiple nodes that share the available CPU limit.
For example, you can purchase a 32-CPU Commercial license and set up an InfluxDB 3 Enterprise cluster with the following:
- 3 × writer nodes, each with 4 CPUs (12 total)
- 1 × compactor node with 8 CPUs
- 3 × query nodes, each with 4 CPUs (12 total)
With the InfluxDB 3 Enterprise Commercial license, CPU cores are purchased in batches of 8, 16, 32, 64, or 128 cores.
CPU accounting
CPU cores are determined by whatever the operating system of the host machine reports as its core count. InfluxDB 3 Enterprise does not differentiate between physical and virtual CPU cores.
If using Linux, InfluxDB uses whatever cgroup CPU accounting is active–for
example: cpuset
or cpu.shares
.
Activate a license
Each InfluxDB 3 Enterprise license must be activated, but the process of activating the license depends on the license type:
Activate a trial or at-home license
When starting the InfluxDB 3 Enterprise server, it asks what type of
license you would like to use.
Select trial
or home
and provide your
email address.
The server auto-generates and stores your license.
The license file is a JWT file that contains the license information.
Use an existing trial or at-home license
When you activate a trial or at-home license, InfluxDB registers your email address with the license server. To use your existing license–for example, if you deleted your license file–provide your email address using one of the following methods:
- Use the
--license-email
option with theinfluxdb3 serve
command - Set the
INFLUXDB3_ENTERPRISE_LICENSE_EMAIL
environment variable
InfluxDB validates your email address with the license server and uses your existing license if it’s still valid.
Activate a commercial license
Contact InfluxData Sales to obtain an InfluxDB 3 Enterprise Commercial license. Provide the following:
- Cluster UUID
- Object Store Info
This information is provided in the output of the InfluxDB 3 Enterprise server if you try to start the server without a valid license.
InfluxData will provide you with a commercial license file. The license file is a JWT file that contains the license information.
When starting the InfluxDB 3 Enterprise server, provide the license file path using one of the following methods:
- Use the the
--license-file
option with theinfluxdb3 serve
command - Set the
INFLUXDB3_ENTERPRISE_LICENSE_FILE
environment variable.
- Use the the
License detection
InfluxDB 3 Enterprise checks for a license file in the following order:
The license file path provided with the
--license-file
optionThe license file path provided with the
INFLUXDB3_ENTERPRISE_LICENSE_FILE
environment variableThe default license path:
/<OBJECT_STORE>/<CLUSTER_ID>/commercial_license
A trial or at-home license stored in the default location
/<OBJECT_STORE>/<CLUSTER_ID>/trial_or_home_license
The license email provided with the
--license-email
optionThe license email provided with the
INFLUXDB3_ENTERPRISE_LICENSE_EMAIL
environment variableIf no license is found, the server won’t start
Example: Start the InfluxDB 3 Enterprise server with your license email:
influxdb3 serve \
--cluster-id cluster01 \
--node-id node01 \
--license-email example@email.com \
# ...
INFLUXDB3_ENTERPRISE_LICENSE_EMAIL=example@email.com
influxdb3 serve \
--cluster-id cluster01 \
--node-id node01 \
# ...
Example: Start the InfluxDB 3 Enterprise server with your license file:
influxdb3 serve \
--cluster-id cluster01 \
--node-id node01 \
--license-file /path/to/license-file.jwt \
# ...
INFLUXDB3_ENTERPRISE_LICENSE_FILE=/path/to/license-file.jwt
influxdb3 serve \
--cluster-id cluster01 \
--node-id node01 \
# ...
For more information about influxdb3 serve
options, see the
CLI reference.
Renew a license
To renew an InfluxDB 3 Enterprise Commercial license, contact InfluxData Sales.
Expiration behavior
When your InfluxDB 3 Enterprise license expires, the following occurs:
- Write requests continue to be accepted and processed.
- Compactions continue to optimize persisted data.
- Query requests return an error.
- If the InfluxDB 3 Enterprise server stops, it will not restart without a valid, non-expired license.
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB 3 Enterprise and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support. Customers using a trial license can email trial@influxdata.com for assistance.