> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pangolin.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Enterprise Edition

> Learn about Enterprise Edition licensing, plans, and how to get started

<div id="pangolin-toc-cta" className="pangolin-toc-cta-source">
  <Card title="Try free on Pangolin Cloud" icon="cloud" href="https://app.pangolin.net/auth/signup" arrow="true" cta="Sign up free">
    Fastest way to get started with Pangolin using the hosted control plane. No credit card required.
  </Card>
</div>

When self-hosting Pangolin, you can run the **Community Edition** or the **Enterprise Edition**. Both editions provide the same core functionality. Enterprise Edition unlocks additional features with a license key on the `ee` Docker image.

<Check>
  Enterprise Edition is **free** for personal use and organizations with **less than \$100,000 USD** gross annual revenue. You still need a valid license key to activate it.
</Check>

<Warning>
  Organizations with **\$100,000+ USD** gross annual revenue require a **paid commercial license** to use Enterprise Edition.
</Warning>

<CardGroup cols={3}>
  <Card title="Get a free license" icon="user" href="#get-a-free-license-personal-use">
    Personal use and small organizations under the revenue threshold.
  </Card>

  <Card title="Compare features and plans" icon="table-list" href="https://pangolin.net/pricing#Self-Hosted-identity-and-access-management">
    Full feature comparison and plan tiers for self-hosted Pangolin.
  </Card>

  <Card title="Purchase a license" icon="credit-card" href="/self-host/purchase-license-key">
    Paid commercial licenses for businesses above the revenue threshold.
  </Card>
</CardGroup>

## Licensing Overview

Enterprise Edition is distributed under the **Fossorial Commercial License**. Your organization's gross annual revenue determines whether you qualify for a free license or need a paid one.

### Personal Use

Free for individuals and small businesses:

* **Revenue threshold**: Less than \$100,000 USD gross annual revenue
* **License cost**: Free
* **Usage**: Personal and small business use allowed

You still need to apply for a valid license key to unlock Enterprise features, even with free licensing.

### Business Use

Larger businesses require a paid license:

* **Revenue threshold**: \$100,000+ USD gross annual revenue
* **License cost**: Paid license required — see [Self-Hosted pricing](https://pangolin.net/pricing#Self-Hosted) for tiers
* **Usage**: Business use with commercial terms
* **Trial**: Want to evaluate Enterprise Edition before buying? Contact [sales@pangolin.net](mailto:sales@pangolin.net) to request a free limited trial license.

Businesses exceeding the revenue threshold must purchase a commercial license to use Enterprise Edition.

## Enterprise Features and Plans

Enterprise Edition unlocks capabilities beyond Community Edition. Your license tier determines which features and limits apply.

<Card title="View full feature comparison" icon="table-list" href="https://pangolin.net/pricing#Self-Hosted-identity-and-access-management">
  The Self-Hosted pricing page is the source of truth for features, limits, and plan tiers.
</Card>

<Tip>
  For setup instructions on a specific feature, search the docs or browse from the pricing page. Individual doc pages mark Enterprise-only features with notes linking back to this page.
</Tip>

## Hiding Enterprise Features on Community Edition

On Community Edition, Enterprise-only capabilities may still appear in the dashboard but remain locked without the `ee` Docker image and a valid license key. To hide those UI elements entirely, set `disable_enterprise_features` under `flags` in your [`config.yml`](/self-host/advanced/config-file):

```yaml theme={"theme":"gruvbox-light-hard"}
flags:
  disable_enterprise_features: true
```

When enabled, Enterprise-only features are hidden from the UI. Restart the stack after updating the configuration file.

## Get a Free License (Personal Use)

<Steps>
  <Step title="Create an account">
    Visit [app.pangolin.net](https://app.pangolin.net) and create your account.
  </Step>

  <Step title="Create an organization">
    After signing up you will be prompted to create an organization. This is required to apply for a license key.
  </Step>

  <Step title="Complete the license application">
    Go to the **Licenses** section in your account dashboard and complete the license application form.

    <Warning>
      Inaccurate representation is a violation of the license and will result in the license being revoked.
    </Warning>
  </Step>

  <Step title="Receive your key">
    Once approved, you'll receive your license key immediately. Continue to [Activate Enterprise Edition](#activating-enterprise-edition) to use it on your server.
  </Step>
</Steps>

Organizations above the revenue threshold should [purchase a commercial license](/self-host/purchase-license-key) instead. See [Self-Hosted pricing](https://pangolin.net/pricing#Self-Hosted) for paid tiers.

## Purchase a License (Business Use)

Businesses with \$100,000+ USD gross annual revenue need a paid commercial license.

### Self-serve Purchase

You can buy a **Starter** or **Scale** license online at any time through [app.pangolin.net](https://app.pangolin.net). Follow the steps in [Purchase a license key](/self-host/purchase-license-key) to choose your tier, complete checkout, and receive your key immediately. Compare features and limits on the [Self-Hosted pricing page](https://pangolin.net/pricing#Self-Hosted-identity-and-access-management), then activate your key — see [Activate Enterprise Edition](#activating-enterprise-edition).

### Custom Licensing

Need more users, more sites, or special add-ons — such as compliance packages, SLA support, pay-by-invoice, or bank transfer? Contact [sales@pangolin.net](mailto:sales@pangolin.net) for a custom quote.

<Info>
  Not ready to purchase? Businesses can request a **free limited trial** of Enterprise Edition by emailing [sales@pangolin.net](mailto:sales@pangolin.net). Include your organization details and what you'd like to evaluate.
</Info>

## Upgrade from Community Edition

If you're already running Community Edition and want Enterprise features:

<Steps>
  <Step title="Get a license key">
    Apply for a [free license](#get-a-free-license-personal-use) or [purchase a commercial license](/self-host/purchase-license-key), depending on your organization's revenue.
  </Step>

  <Step title="Switch to the Enterprise image">
    Update your Docker Compose configuration:

    ```yaml theme={"theme":"gruvbox-light-hard"}
    services:
      pangolin:
        image: fosrl/pangolin:ee-latest  # Enterprise Edition
        # ... rest of configuration
    ```

    <Warning>
      The Enterprise Edition image is tagged with `ee` (e.g., `fosrl/pangolin:ee-latest`) and is different from the Community Edition (`fosrl/pangolin:latest`).
    </Warning>
  </Step>

  <Step title="Restart the stack">
    ```bash theme={"theme":"gruvbox-light-hard"}
    sudo docker compose down && sudo docker compose up -d
    ```
  </Step>

  <Step title="Activate your license key">
    Log in with server admin credentials, open the Server Admin panel, and go to the License section at `/admin/license`. Enter and activate your key.
  </Step>

  <Step title="Verify activation">
    Confirm Enterprise Edition features are unlocked in your dashboard.
  </Step>
</Steps>

## Activating Enterprise Edition

Use these steps if you're setting up Enterprise Edition for the first time (including after a fresh install with the `ee` image).

<Steps>
  <Step title="Use Enterprise Edition image">
    Your Docker Compose configuration must use the Enterprise Edition image:

    ```yaml theme={"theme":"gruvbox-light-hard"}
    services:
      pangolin:
        image: fosrl/pangolin:ee-latest  # Enterprise Edition
        # ... rest of configuration
    ```
  </Step>

  <Step title="Restart the stack">
    ```bash theme={"theme":"gruvbox-light-hard"}
    sudo docker compose down && sudo docker compose up -d
    ```
  </Step>

  <Step title="Add license key to instance">
    Log in to the Pangolin instance via the server admin credentials. Visit the Server Admin panel and navigate to the License section (`/admin/license`). Enter and activate the license key.

    <Info>
      The license key should be provided exactly as received in your email confirmation.
    </Info>
  </Step>

  <Step title="Verify activation">
    Check your Pangolin dashboard to confirm Enterprise Edition features are unlocked.
  </Step>
</Steps>

### Troubleshooting Activation

<AccordionGroup>
  <Accordion title="Admin panel still shows Community Edition">
    You're likely running the Community Edition Docker image. Confirm your `docker-compose.yml` uses `fosrl/pangolin:ee-latest` (or a pinned version like `fosrl/pangolin:ee-1.14.1`), not `fosrl/pangolin:latest`. Restart the stack after changing the image:

    ```bash theme={"theme":"gruvbox-light-hard"}
    sudo docker compose down && sudo docker compose up -d
    ```

    Check container logs if the issue persists:

    ```bash theme={"theme":"gruvbox-light-hard"}
    sudo docker compose logs pangolin
    ```
  </Accordion>

  <Accordion title="No License section in the admin panel">
    The License section only appears when the Enterprise Edition image is running. Switch to the `ee` image and restart the stack — see the accordion above.
  </Accordion>

  <Accordion title="Enterprise settings are missing after activation">
    Some features require a valid activated license **and** additional configuration. For example, branding and certain identity provider settings need a [`privateConfig.yml`](/self-host/advanced/private-config-file) file mounted in your container. Verify your license is active and check the docs for the specific feature you're enabling.
  </Accordion>
</AccordionGroup>

## License Requirements

<AccordionGroup>
  <Accordion title="How many license keys do I need?">
    **One key per Pangolin server instance**

    Each host (server) running Pangolin requires its own license key. You cannot share a single key across multiple servers. A server is considered to be a single database instance.
  </Accordion>

  <Accordion title="Can I get a trial license?">
    Yes. Businesses that require a paid commercial license can request a **free limited trial** of Enterprise Edition by contacting [sales@pangolin.net](mailto:sales@pangolin.net). Include your organization details and which features you want to evaluate.

    Trial licenses are intended for organizations above the personal-use revenue threshold that want to test Enterprise Edition before purchasing.
  </Accordion>

  <Accordion title="What if I'm unsure about my license type?">
    If you're uncertain whether you qualify for free licensing or need a commercial license, reach out to [sales@pangolin.net](mailto:sales@pangolin.net) with your organization details.
  </Accordion>
</AccordionGroup>

## FAQ

<AccordionGroup>
  <Accordion title="What features does Enterprise Edition include?">
    Enterprise Edition unlocks advanced features beyond Community Edition.

    See the [Self-Hosted pricing page](https://pangolin.net/pricing#Self-Hosted-identity-and-access-management) for the full feature comparison — it is the source of truth for what each plan includes.
  </Accordion>

  <Accordion title="What are Paid Features?">
    "Paid Features" refers to the advanced capabilities unlocked by Enterprise Edition with a valid license key. Personal and small-business users get a free license. Larger organizations purchase a paid license.

    For the complete list, see [Self-Hosted pricing](https://pangolin.net/pricing#Self-Hosted).
  </Accordion>

  <Accordion title="Can I use Enterprise Edition for personal projects?">
    Yes. Individuals and small businesses under the \$100,000 USD revenue threshold can use Enterprise Edition for personal projects at no cost. [Apply for a free license](#get-a-free-license-personal-use) to get started.
  </Accordion>

  <Accordion title="Why would a business pay for self-hosted Enterprise Edition?">
    Paid tiers unlock features most organizations need at scale: external identity providers and RBAC, multi-organization support and branding, and custom limits with SIEM streaming and SLA support.

    Compare tiers on the [Self-Hosted pricing page](https://pangolin.net/pricing#Self-Hosted) to find the right fit.
  </Accordion>

  <Accordion title="Is self-hosted Enterprise Edition the same as Pangolin Cloud?">
    No. Self-hosted Enterprise Edition runs on your own infrastructure with a license key on the `ee` Docker image. [Pangolin Cloud](https://app.pangolin.net/auth/signup) is a managed hosting option with its own pricing tab on the [pricing page](https://pangolin.net/pricing#Self-Hosted). Both offer advanced features, but the deployment model is different.
  </Accordion>

  <Accordion title="Is Enterprise Edition opt-in?">
    Yes. You can continue using the Community Edition indefinitely. Enterprise Edition requires switching to the `ee` Docker image and activating a license key.
  </Accordion>

  <Accordion title="Can I switch between editions?">
    Yes. Switching between Community and Enterprise Edition is a **container swap** — update the Docker image in your `docker-compose.yml` and restart the stack:

    * **To Enterprise:** `fosrl/pangolin:ee-latest` (or a pinned `ee-<version>` tag), then activate your license key at `/admin/license`
    * **To Community:** `fosrl/pangolin:latest` (or a pinned community tag)

    Community and Enterprise Edition share the same database schema, so there should be no data migration issues. You can freely switch between versions to test. Enterprise-only features are disabled when running the Community image.

    <Tip>
      Always back up your database and configuration before switching editions, just in case.
    </Tip>
  </Accordion>

  <Accordion title="Can I downgrade from Enterprise to Community Edition?">
    Yes. Downgrading is a simple container swap:

    1. Change your Docker image from `fosrl/pangolin:ee-latest` to `fosrl/pangolin:latest` (or the matching community version tag)
    2. Restart the stack: `sudo docker compose down && sudo docker compose up -d`

    Community and Enterprise Edition use the **same database schema**, so you should not run into data migration issues. You can freely switch between editions to test. Enterprise-only features will be disabled on the Community image, but your existing data remains intact.

    <Tip>
      Always make a backup of your database and configuration before switching, just in case.
    </Tip>
  </Accordion>

  <Accordion title="What happens if my license expires?">
    If your license expires or becomes invalid:

    * Enterprise features will be disabled
    * You can renew your license to restore Enterprise features
  </Accordion>

  <Accordion title="Are there special license terms for educational institutions, non-profits, or government organizations?">
    No. Educational institutions, non-profit organizations, and government entities are subject to the same license terms as all other organizations. There are no special exceptions or discounts.

    <Info>
      If you have questions about how your organization's revenue is calculated for licensing purposes, contact [sales@pangolin.net](mailto:sales@pangolin.net).
    </Info>
  </Accordion>
</AccordionGroup>

## Support and Contact

For licensing questions and quotes, email [sales@pangolin.net](mailto:sales@pangolin.net). Include your organization details and use case for faster assistance.