Skip to main content
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.
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.
Organizations with $100,000+ USD gross annual revenue require a paid commercial license to use Enterprise Edition.

Get a free license

Personal use and small organizations under the revenue threshold.

Compare features and plans

Full feature comparison and plan tiers for self-hosted Pangolin.

Purchase a license

Paid commercial licenses for businesses above the revenue threshold.

​
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 for tiers
  • Usage: Business use with commercial terms
  • Trial: Want to evaluate Enterprise Edition before buying? Contact 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.

View full feature comparison

The Self-Hosted pricing page is the source of truth for features, limits, and plan tiers.
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.

​
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:
When enabled, Enterprise-only features are hidden from the UI. Restart the stack after updating the configuration file.

​
Get a Free License (Personal Use)

1

Create an account

Visit app.pangolin.net and create your account.
2

Create an organization

After signing up you will be prompted to create an organization. This is required to apply for a license key.
3

Complete the license application

Go to the Licenses section in your account dashboard and complete the license application form.
Inaccurate representation is a violation of the license and will result in the license being revoked.
4

Receive your key

Once approved, you’ll receive your license key immediately. Continue to Activate Enterprise Edition to use it on your server.
Organizations above the revenue threshold should purchase a commercial license instead. See Self-Hosted pricing 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. Follow the steps in Purchase a license key to choose your tier, complete checkout, and receive your key immediately. Compare features and limits on the Self-Hosted pricing page, then activate your key — see Activate 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 for a custom quote.
Not ready to purchase? Businesses can request a free limited trial of Enterprise Edition by emailing sales@pangolin.net. Include your organization details and what you’d like to evaluate.

​
Upgrade from Community Edition

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

Get a license key

Apply for a free license or purchase a commercial license, depending on your organization’s revenue.
2

Switch to the Enterprise image

Update your Docker Compose configuration:
The Enterprise Edition image is tagged with ee (e.g., fosrl/pangolin:ee-latest) and is different from the Community Edition (fosrl/pangolin:latest).
3

Restart the stack

4

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.
5

Verify activation

Confirm Enterprise Edition features are unlocked in your dashboard.

​
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).
1

Use Enterprise Edition image

Your Docker Compose configuration must use the Enterprise Edition image:
2

Restart the stack

3

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.
The license key should be provided exactly as received in your email confirmation.
4

Verify activation

Check your Pangolin dashboard to confirm Enterprise Edition features are unlocked.

​
Troubleshooting Activation

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:
Check container logs if the issue persists:
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.
Some features require a valid activated license and additional configuration. For example, branding and certain identity provider settings need a privateConfig.yml file mounted in your container. Verify your license is active and check the docs for the specific feature you’re enabling.

​
License Requirements

One key per Pangolin server instanceEach 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.
Yes. Businesses that require a paid commercial license can request a free limited trial of Enterprise Edition by contacting 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.
If you’re uncertain whether you qualify for free licensing or need a commercial license, reach out to sales@pangolin.net with your organization details.

​
FAQ

Enterprise Edition unlocks advanced features beyond Community Edition.See the Self-Hosted pricing page for the full feature comparison — it is the source of truth for what each plan includes.
“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.
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 to get started.
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 to find the right fit.
No. Self-hosted Enterprise Edition runs on your own infrastructure with a license key on the ee Docker image. Pangolin Cloud is a managed hosting option with its own pricing tab on the pricing page. Both offer advanced features, but the deployment model is different.
Yes. You can continue using the Community Edition indefinitely. Enterprise Edition requires switching to the ee Docker image and activating a license key.
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.
Always back up your database and configuration before switching editions, just in case.
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.
Always make a backup of your database and configuration before switching, just in case.
If your license expires or becomes invalid:
  • Enterprise features will be disabled
  • You can renew your license to restore Enterprise features
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.
If you have questions about how your organization’s revenue is calculated for licensing purposes, contact sales@pangolin.net.

​
Support and Contact

For licensing questions and quotes, email sales@pangolin.net. Include your organization details and use case for faster assistance.