> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.jambonz.org/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.jambonz.org/_mcp/server.

# Software Licensing

## Overview

Self-hosted jambonz requires a software license key.  The license key is tied to the domain name
you choose when you deploy jambonz on your infrastructure.

Once you have followed the instructions to deploy the jambonz system, you are ready to obtain a software license.
When you first log into the jambonz portal,
you will see a beige banner at the top of the window indicating that the system is unlicensed.

![Unlicensed banner](file:docs/assets/images/licensing-unlicensed-banner.jpg "Unlicensed system banner")

Clicking on the link on the Settings page will take you to the settings page where you can enter a license key.
You will see there a link to the [licensing portal](https://licensing.jambonz.org).

## Creating an account on the licensing portal

![Settings page with licensing portal link](file:docs/assets/images/licensing-settings.jpg "Settings page")

Clicking on that link will take you to the licensing portal. Create an account using either email or google login and then sign in.
You will see a page listing the jambonz domains that you have deployed.  It will initially be empty.

![Licensing portal with no domains](file:docs/assets/images/licensing-no-domains.jpg "Empty domains list")

## Adding your deployed domain

Click on the "Add Domain" button to add your deployed jambonz domain.  You will be prompted to enter the domain name at the top
of the page.  Enter the domain name you specified during deployment and then click the Add button.  You will see your
domain has been added to the list with a status of "Unlicensed".

## Obtaining a license key

Click on the "Buy license key" button for the domain that you just added.

### Free trial license

You can obtain a free trial license key for evaluation purposes that is good for 30 days.
To do so, click on the "Request Trial License" at the bottom of the Add License popup.
This will bring you to the Free trial form as shown below.

![Free trial license form](file:docs/assets/images/licensing-trial-license.jpg "Trial license request form")

Note that by default trial licenses are restricted to 10 concurrent sessions.
If you feel you need a higher concurrent session limit for your evaluation, please contact us to request that.

Click on the Proceed button and you will see your trial license key displayed and you can now copy it to the clipboard.

> **Note**
>
> Trial licenses are limited to one per domain. Once you have used your free trial, you will need
> to purchase a paid license. If you need an extended trial for
> non-commercial use, please contact us at [support@jambonz.org](mailto:support@jambonz.org).

### Production license

To purchase a production license, click on "Buy License" on the Domains page and then select or enter the desired number of concurrent sessions or "Unlimited".
Click on the "Proceed to purchase" button to review and accept the license terms.

Once you have accepted the terms you will be taken to the payment page to enter your payment details.
After entering your payment details and pressing the Pay button, you will see your license key displayed.

> **Note**
>
> Subscription licenses are billed monthly.
> Once the initial license key is installed in your jambonz system, it will automatically update
> monthly with no interruption in service as long as your payment method remains valid.
>
> You will
> be notified via email if a recurring payment fails for any reason, and you will have an opportunity to
> update your payment method before service is interrupted.

## Installing your license key

Copy the license key from the licensing portal and return to your jambonz portal settings page.
Paste the license key into the License Key field and click the "Add License" button.

![Installing license key in settings](file:docs/assets/images/licensing-add-license.jpg "Add license key to settings")

Voila!  Your jambonz system is now licensed and ready for production use.

> **Note**
>
> It may take thirty seconds or so for the jambonz SIP server to recognize the new license key and begin accepting calls.

## Upgrading a trial license

To upgrade a trial license to a production license, log into licensing portal and click on the dropdown
menu for the domain with the trial license.  Select "View" and then "Upgrade License".

## Canceling a license

To cancel a production license, log into the licensing portal and click on the dropdown menu for the domain with the
license you wish to cancel.  Select "Modify" and then on the subsequent dialog box click on
"I'd like to cancel my subscription".

You will see that the license status changes to "Final Bill Cycle".
You will have full use of the license until the end of the current billing cycle,
at which point the license will expire
and your jambonz system will revert to unlicensed status.

## Third-Party Feature Licenses

Some jambonz features require separate licenses from third-party vendors. These are **not included** with the jambonz software license.

### Krisp Turn Detection and Noise Isolation

> **Krisp API License Required**
>
> The [agent](/verbs/verbs/agent) verb's Krisp turn detection and noise isolation features require a **separate Krisp API license key** for self-hosted deployments. Without a valid Krisp license, these features will not function.
>
> This applies to:
>
> * `turnDetection: "krisp"` in the agent verb
> * `noiseIsolation: "krisp"` in the agent verb
>
> **To obtain a Krisp license:** Contact [support@jambonz.org](mailto:support@jambonz.org) for information on pricing and how to configure your Krisp API credentials.
>
> This requirement does not apply to jambonz.cloud customers — Krisp features are included with all jambonz.cloud plans.

**Alternatives that don't require additional licensing:**

* Use `turnDetection: "stt"` (the default) to rely on your STT vendor's native end-of-utterance detection
* Use STT vendors with built-in turn detection: Deepgram Flux, AssemblyAI, or Speechmatics
* Use `noiseIsolation: "rnnoise"` for open-source noise cancellation (no license required)

## Telemetry

Licensed instances send a small amount of  data back to a central Jambonz hosted server so that we can monitor usage, We collect the following data:

### Events

#### Hourly call statistics

Each instance reports, once per hour; inbound / outbound / total concurrent call counts, as min and max over the hour (inbound\_min/max, outbound\_min/max, total\_min/max)

#### License-install events

Sent when a license is installed (trials, renewals, rebuilds):

* maxSessions (or "unlimited"), expirationDate
* hostingProvider and hostingRegion (e.g. cloud + region)

#### Session-limit-reached events

When an instance hits its session cap: direction (inbound/outbound), currentSessions, maxSessions, sentBy
Throttled to 1 per domain/direction/minute; also triggers an email to the customer + support team.

#### Tampering events

When we detect license tampering.

#### License check-ins

It records a check-in timestamp per domain and the version.

### Identifiers attached to every event

Across all measurements, each point is tagged/stamped with:

* domain
* customerSid
* publicIp and privateIp of the instance

### What it does not collect

No call content, no per-call CDRs, no caller/callee numbers, no SIP payloads, no customer PII beyond the systems domain/IP.

> **Note**
>
> If you require an air-gapped deployemnt without the requirement to send license data then please  contact us at [support@jambonz.org](mailto:support@jambonz.org).