> For the complete documentation index, see [llms.txt](https://adatrack.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adatrack.gitbook.io/docs/documentation/administration/quotas.md).

# Quota Management

To ensure system stability and fair resource distribution, AdaTrack employs a **Quota Management** system. Quotas limit the number of resources a user can create and the amount of data they can process based on their subscription tier.

## What is a Quota?

A quota is a "hard limit" on a specific resource type. Once a quota is reached, you will be unable to create new instances of that resource until you either delete existing ones or upgrade your subscription.

## Monitored Resources

AdaTrack monitors the following resource quotas:

* **Devices:** The maximum number of active IoT devices registered in your account.
* **Device Profiles:** The number of unique hardware templates (decoders) you can maintain.
* **Device Categories:** The number of custom device categories you can create. System categories (GPS Tracker, Environmental Sensor, etc.) do not count toward this limit. See [Device Categories](/docs/documentation/features/device-categories.md).
* **Geofences:** The total number of virtual perimeters you can define on the map.
* **Alert Rules:** The number of active telemetry or geofence monitoring rules.
* **Dashboards:** The number of custom interactive dashboards you can build.
* **Scheduled Reports:** The number of automated daily/weekly/monthly reports you can configure.

## Usage Ledger (Metered Quotas)

In addition to static resource limits, AdaTrack tracks **Metered Usage** for certain high-volume activities:

* **Telemetry Packets:** The total number of UDP packets processed and decoded.
* **Workflow Executions:** The number of times your automated flows have been triggered.
* **API Requests:** The number of calls made to the AdaTrack HTTP API.
* **AI Tokens:** The number of LLM tokens consumed by the [AI Assistant plugin](/docs/documentation/features/plugins.md), across both chat messages and AI Analysis workflow nodes. Enforced before every LLM call — a request that would exceed the monthly limit is blocked (and the AI Analysis workflow node fails with a quota-exceeded error) rather than metered after the fact.

These are tracked in the **Usage Ledger**, and for users on [Flexible Tiers](/docs/documentation/administration/billing.md), they form the basis of the monthly bill.

## Checking your Quota Status

You can view your current quota usage in two places:

1. **Account Overview:** A high-level summary of your main resource limits.
2. **Module Sidebars:** Many pages (like Devices or Geofencing) show a small progress bar (e.g., "Devices: 8/10") at the top of the list view.

## What Happens When a Quota is Reached?

1. **UI Warning:** The "Create" or "Add" button for that resource will be disabled.
2. **API Error:** If you attempt to create a resource via the API, the system will respond with a `403 Forbidden` error and a message indicating the quota breach.
3. **Notifications:** For metered quotas (like packet counts), AdaTrack will send an email notification when you reach 80% and 100% of your monthly limit.

## How to Increase Quotas

* **Upgrade your Tier:** Switching from **Free** to **Pro** or **Flexible** significantly increases or removes most resource quotas.
* **Delete Unused Resources:** Removing old devices, geofences, or reports will immediately free up space in your current quota.
* **Request Bonus Quota:** In some cases, administrators can grant "Bonus Quota" for specific needs without changing your subscription tier.

## Self-Hosted Quotas

When running AdaTrack in [Self-Hosted Mode](/docs/documentation/getting-started/self-hosted.md), resource quotas are determined by your [license tier](/docs/documentation/administration/licensing.md):

* **Community Edition (no license):** A generous free tier with fixed limits (e.g., 5 devices, 10 alert rules, 50,000 requests/month). All features are available.
* **Standard License:** Significantly higher limits suitable for production workloads (e.g., 250 devices, 2M requests/month).
* **Enterprise License:** Unlimited resources with no caps.

Quota enforcement in self-hosted mode works identically to SaaS — the same UI warnings, API errors, and progress indicators apply. The difference is that limits come from your license rather than a subscription tier. See the [Licensing guide](/docs/documentation/administration/licensing.md) for how to set up and upgrade your license.