License management

Activating your 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 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 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 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 no longer have access to licensed-tier features.