Overage activation
In SonarQube Server 2026.5, activate and manage overage for Remediation Agent, Sonar Vortex, Hunter Agent, and Lines of Code (LOC) in Enterprise and Data Center editions.
Activate overage to keep using a product without interruption when your base usage allowance runs out. Usage for each product is tracked in its own consumption unit.
The following products support overage:
Remediation Agent, measured in What counts as a suggestion
Sonar Vortex, measured in What counts as a tool call
Hunter Agent, measured in What counts as a scan unit
Advanced Security does not support overage. It provides full access without usage limits.
Overage is available on Enterprise and Data Center edition instances that use online license activation and send daily pings to LicenseSpring. Overage is billed at a higher rate than your base subscription allowance. If you're consistently consuming overage, contact your Sonar account representative to adjust your core subscription.
How overage works
Overage usage is measured against a hard cap you define. When the cap is reached, new analyses are blocked until you raise the cap, the cap resets, or you contact your Sonar account representative to upgrade your existing contract.
Invoice creation and cap resets vary by product:
Remediation Agent
Monthly
Monthly
Start of next calendar month
Sonar Vortex
Monthly
Monthly
Start of next calendar month
Hunter Agent
Monthly
Monthly
At the end of the contract term
Overage is billed monthly, based on actual usage above your base allowance. For Remediation Agent and Sonar Vortex, the base allowance and overage tracking reset at the start of each calendar month. For Hunter Agent, both reset only at the end of the contract term. Unused overage capacity does not carry forward to the next reset.
The License manager page displays your total contract Hunter Agent overage What counts as a scan unit, but overage billing occurs on a monthly basis.
LOC overage is also invoiced monthly, based on the highest LOC peak recorded above your cap that month. Like Remediation Agent and Sonar Vortex, the cap resets at the start of each calendar month. See LOC overage for how it's calculated.
Activate overage
Note: Overage requires online license activation. If your instance uses a server ID-based license key, overage is not available.
Overage requires continuous network connectivity. If your instance loses connectivity, overage usage and new analyses may be blocked until the connection is restored.
To activate overage for a product:
Go to Administration > Configuration > License manager.
In the Overage limit column next to the product, select Activate overage.
Select Allow overage usage and enter a value for Set monthly overage limit.
Select Next.
Accept the terms and conditions and select Activate overage.
Overage takes effect immediately. No new license key is required. After your first activation, select Manage overage to update your settings. At the start of the following month, you'll receive an invoice for any overage usage by email.
If the Overage limit column doesn't show Activate overage or Manage overage, one of the following applies:
Your edition isn't Enterprise or Data Center.
Your instance doesn't use online license activation.
Your codebase has 100 million or more lines of code.
There's a payment issue on your account. Contact Sonar support to resolve it.
Your finance team hasn't agreed to overage billing. Contact your Sonar account representative.
Track and manage overage
The Overage limit column shows your current consumption against the overage cap. When the cap is reached, new analyses are blocked until you raise the cap, the cap resets, or you contact your Sonar account representative to upgrade your existing contract.
To adjust the cap:
In the Overage limit column, select Manage overage next to the product.
Enter a new value for Set monthly overage limit.
Select Next.
Accept the terms and conditions and select Confirm new limit.
The new cap takes effect immediately.
Deactivate overage
Deactivating overage removes the extra cap. The product continues running until your base subscription allowance is consumed; when it's fully consumed, new analyses are blocked until the base allowance resets or you contact your Sonar account representative to upgrade your existing contract. For Remediation Agent and Sonar Vortex, the base allowance resets at the start of the next calendar month. For Hunter Agent, it resets at the end of the contract term. See How overage works.
To deactivate overage for a product:
In the Overage limit column, select Manage overage next to the product.
Clear the Allow overage usage checkbox.
Select Deactivate overage.
Overage used before deactivation appears on your next invoice. You can re-activate overage at any time.
Overage notifications
Administrators receive email notifications when overage consumption reaches the following thresholds:
When overage consumption begins.
80% of the overage cap is reached.
100% of the overage cap is reached.
LOC overage
SonarQube Server enforces a Lines of Code (LOC) limit based on your license, shown as Purchased LOC. Activate LOC overage to continue analyzing your codebase without interruption if it exceeds this limit.
LOC overage is available on Enterprise and Data Center edition instances that use online license activation and send daily pings to LicenseSpring. LOC overage is billed at a higher rate than your base subscription. If you're consistently consuming LOC overage, contact your Sonar account representative to adjust your core subscription.
How overage is calculated
LOC overage is invoiced monthly, based on the highest LOC peak recorded above your Purchased LOC limit during that month, not on your average or total usage. The recorded peak resets at the start of each calendar month. If your codebase temporarily grows above the limit and then falls back, billing reflects the highest peak that exceeded the limit, not cumulative excess. Brief spikes are not smoothed or excluded from the calculation.
Activate LOC overage
LOC overage requires continuous network connectivity. If your instance loses connectivity, LOC overage and new analyses may be blocked until the connection is restored.
To activate LOC overage:
Go to Administration > Configuration > License manager.
In the Lines of code section, select Activate overage.
Select Allow overage usage and enter a value for Set monthly overage limit.
Select Next.
Accept the terms and conditions and select Activate overage.
LOC overage takes effect immediately. No new license key is required. After your first activation, select Manage overage to update your settings.
If you don't see Activate overage or Manage overage, check the following:
Talk to sales: your account is not yet entitled to LOC overage. Contact your Sonar account representative to enable it.
Talk to support: there is a pricing error on your account. Contact Sonar support to resolve it.
Not applicable: LOC overage is not available for your edition or activation method.
Track and manage LOC overage
The Lines of code section shows your current LOC overage consumption against the hard cap. When the cap is reached, new analyses are blocked until you raise the cap.
To adjust the cap:
In the Lines of code section, select Manage overage.
Enter a new value for Set monthly overage limit.
Select Next.
Accept the terms and conditions and select Confirm new limit.
The new cap takes effect immediately.
LOC overage notifications
Administrators receive email notifications when LOC overage consumption reaches the following thresholds:
When LOC overage consumption begins.
80% of the LOC overage cap is reached.
100% of the LOC overage cap is reached.
If you use online license activation, you can increase the overage cap at any time. See Track and manage LOC overage.
For notifications about your base Purchased LOC limit, see the Lines of Code page.
Last updated
Was this helpful?