License management

Activating your commercial license

If you haven’t already, install the backend, agent, and sensuctl and configure sensuctl.

Log in to your Sensu account at and download your license file using the “Download license” link.

Sensu account: Download Sensu license.

Screenshot of Sensu account license download

With the license file downloaded, you can activate your license using sensuctl or the license API.

To activate your license using sensuctl:

sensuctl create --file sensu_license.json

You can use sensuctl to view your license details at any time.

# Active license
sensuctl license info
=== Training Team - Sensu
Account Name: Training Team - Sensu
Account ID:   123
Plan:         managed
Version:      1
Features:     all
EntityLimit:  0
Issuer:       Sensu, Inc.
Issued:       2019-02-15 15:01:44 -0500 -0500
Valid:        true
Valid Until:  2019-03-15 00:00:00 -0800 -0800

# No license found
sensuctl license info
Error: not found

Entity limit

Your commercial license includes the entity limit tied to your Sensu licensing package. An entity limit of 0 allows unlimited entities. Both agent and proxy entities count towards the overall entity limit. Contact us to upgrade your commercial license.

To see your current entity count, use any /api/core or /api/enterprise API request. For example:

curl -v -H "Authorization: Bearer $SENSU_TOKEN"

You should see the current entity count and limit as response headers.

HTTP/1.1 200 OK
Content-Type: application/json
Sensu-Entity-Count: 4
Sensu-Entity-Limit: 0

License expiration

To see your commercial license expiration date, log in to your Sensu account at

If your license is within 30 days of expiration, Sensu issues regular warnings in the Sensu backend logs. If your license expires, you will still have access to commercial features, but your entity limit will drop back down to the free limit of 100.