---
description: This page covers types of Aidbox licenses and describes Aidbox Support tiers.
---

# Licensing and Support

Aidbox offers developers a smooth path from a tiny digital health app prototype to a country-wide deployment of a global healthcare solution. [Health Samurai](https://www.health-samurai.io/) is always around to ensure developers get all the necessary support.

## Aidbox license types

<table data-header-hidden><thead><tr><th width="447"></th><th></th></tr></thead><tbody><tr><td><strong>Aidbox Edition</strong></td><td><strong>Price</strong></td></tr><tr><td>Aidbox production license</td><td>$</td></tr><tr><td>Development license</td><td>free</td></tr></tbody></table>

### Production license

A production license allows running Aidbox for 14 days (trial) and then can be extended by the Health Samurai team for production usage with PHI data. Please [contact us](contact-us.md) for more details.

### Development license

The Aidbox development license is intended exclusively for development, testing, and demonstration purposes. This license comes with specific restrictions and limitations:\
\
\- **No PHI:** Users must not load real healthcare data or Protected Health Information (PHI) into any Aidbox instance operating under a Development license.\
\
\- **Storage Limit**: The Development license permits storage of up to 5 GB of data in your database.

When you reach your database size limit, you’ll receive 2 types of warnings:

{% tabs %}
{% tab title="About to exceed the license limit" %}
`Your database (name of your database) size 4.9 GiB is about to exceed the license limit 5.0 GiB. Please review database size or contact us for further information.`
{% endtab %}

{% tab title="Above license limit" %}
`Your database (name of your database) size is 5.7 GiB and it's above license limit 5.0 GiB. Please review database size or contact us for further information.`
{% endtab %}

{% endtabs %}

### Production-ready Aidbox as a SaaS

You can get a turn-key production-ready Aidbox as a SaaS to start your development in minutes.

{% content-ref url="../getting-started/run-aidbox-on-aws.md" %}
[run-aidbox-on-aws.md](../getting-started/run-aidbox-on-aws.md)
{% endcontent-ref %}

### Aidbox for education

For non-profit educational institutions, the Health Samurai provides Aidbox licenses that can be used for instructional and non-commercial academic research. Please [contact us](contact-us.md) for more information.

## License limits

### Instance limit (`max-instances`)

Each Aidbox license carries a `max-instances` parameter — the maximum number of **concurrent** Aidbox runtimes that can use the license. Each running Aidbox process counts as one instance: every replica of a [highly available](../deployment-and-maintenance/deploy-aidbox/run-aidbox-in-kubernetes/highly-available-aidbox.md) deployment, every staging / production environment that shares the same license, and every long-lived local developer runtime. Read-only PostgreSQL replicas do **not** count — only Aidbox application processes that send heartbeats to [aidbox.app](https://aidbox.app).

The instance count is observed by the [Aidbox license portal](aidbox-user-portal/licenses.md), which the running instances ping on a heartbeat (~30 minutes for production licenses). If the active count exceeds `max-instances`, the portal returns a `max-instances` warning on the next heartbeat refresh.

#### Concurrent instances warning

When over the limit, every running instance receives the warning on its next heartbeat (so the warning shows up on **all** instances simultaneously, ~30 minutes after they start):

* In Aidbox logs: `:license.modern/warning {:max-instances {:type "max-instances", :message "Your current number of concurrent running installations is N. Your possible number is M..."}}`
* On every API response:

  ```http
  License-Mode: normal
  License-Mode-Info: {"warning":{"max-instances":{"message":"Your current number of concurrent running installations is N. Your possible number is M. Please contact Health Samurai for further information"}}}
  ```

The warning is **informational** — `License-Mode` remains `normal` and CRUD, search, and other operations continue working. To clear it, raise `max-instances` on [aidbox.app](https://aidbox.app) to at least the number of replicas you run, or reduce the number of replicas. Read-only DB replicas need no license adjustment because they don't count.

When planning an HA rollout, set `max-instances` **before** scaling up — the warning fires once per heartbeat, so a same-day scale-up is not silently logged as a license breach.

## Aidbox Support

We know that starting with new technology is a challenge. That's why we are inviting Aidbox users to subscribe to one of Aidbox Support tiers from their first days with Aidbox. It might be the time when you need Aidbox Support the most.

Health Samurai offers three support tiers: Basic, Professional, and Enterprise. Below is what you need to know about each of them:

| **Aidbox Support**   | **What is included**                                                                                                                                                                                                                                       | **Price** |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| Basic Support        | <ul><li>Account manager</li><li>Basic Aidbox consulting</li></ul>                                                                                                                                                                                          | \included         |
| Professional Support | <ul><li>Chat with Aidbox engineers</li><li>Monthly video conferences with Aidbox engineers</li><li>Priority fixing of non-blocking issues**</li><li>Priority release of new Aidbox features**</li><li>Aidbox performance optimization consulting</li></ul> | \$\$       |
| Enterprise Support   | <ul><li>Chat with Aidbox engineers</li><li>Weekly conferences with Aidbox engineers</li><li>Aidbox product enhancement or feature release**</li><li>FHIR and Aidbox consultative review and guidance</li></ul>                                             | \$\$\$      |

\*\* - during the next three releases

### Professional services

If you have a development team ready to start, but need that extra expertise to get started or move faster, we can help you at any stage. Aidbox professional services include:

* Aidbox provisioning and maintenance in customers' infrastructure
* Aidbox production-ready deployment as a project
* Aidbox development quick start training
* Operations quick start training
* Migration from another FHIR server/platform to Aidbox
* Project bootstrapping
* Performance tuning and optimization
* Major version upgrade

We can also work with you to build a custom engagement that suits your needs. Please [contact us](contact-us.md) for more info.

### Aidbox deployment services

Health Samurai handles the complete setup of Aidbox in your cloud infrastructure — you provide the environment, we deliver a production-ready, secure, and scalable FHIR platform.

**What we deploy:**

| Component | Description |
|-----------|-------------|
| Multi-environment setup | Staging and Production environments configured to your specifications |
| CI/CD pipeline | Automated deployment workflows for seamless updates |
| HIPAA technical safeguards | Full compliance setup ([learn more](https://www.health-samurai.io/articles/aidbox-hipaa-book-technical-safeguards)) |
| Audit logging | Complete event tracking with built-in log viewer |
| Monitoring & alerting | Dashboards with Aidbox and Kubernetes metrics |
| Disaster recovery | Automated backups, database replicas, and point-in-time recovery |
| SSL management | Automated certificate provisioning and renewal |

See [infrastructure examples](https://www.health-samurai.io/aidbox#Infrastructure) for reference architectures.

### Aidbox maintenance services

After deployment, Health Samurai can take ownership of Aidbox operations — keeping your platform updated, secure, and performing optimally while your team focuses on building your application.

**What's included:**

| Category | Activities |
|----------|------------|
| Updates | Aidbox, PostgreSQL, and Kubernetes version upgrades |
| Security | Vulnerability scans and patch management |
| Monitoring | Cluster health monitoring, error tracking (5xx), real-time alerts |
| Communication | Monthly status meetings, tickets digest, shared dashboards with your DevOps team |
| Optimization | Database and query performance tuning recommendations |

**What remains your responsibility:**

* Your application code and business logic
* Network infrastructure (VPN, VPC, firewalls)

### Performance optimization

For teams requiring peak performance, Health Samurai offers dedicated optimization services that include everything in maintenance plus:

* Continuous performance monitoring and analysis
* Proactive index optimization and query tuning
* Custom recommendations based on your usage patterns

Please [contact us](contact-us.md) to discuss deployment, maintenance, or performance optimization services.

### Aidbox Trial

Aidbox license can be received for a trial period at no cost with the purchase of Aidbox Support. Do not fight your problems alone; get Aidbox Support and [Health Samurai](https://www.health-samurai.io/) on your side!

* 1 month with Basic support
* 2 months with Professional support
* 3 months with Enterprise

To learn about **pricing**, please get in touch [with us](contact-us.md).
