Activate 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 click Download license to download your license file.

Screenshot of Sensu account license download

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

To activate your license with sensuctl:

sensuctl create --file sensu_license.json

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 toward the overall entity limit. Contact Sensu 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_ACCESS_TOKEN"

Your current entity count and limit are listed 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.

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.