Plans and licences
A self-hosted server runs on the Free plan until you add the Team or Enterprise plan. Prices are on stirling.com/pricing. For Stirling Cloud plans, see Plans, credits and billing.
What each plan unlocks#
| Feature | Free | Team | Enterprise |
|---|---|---|---|
| Users | 5 | 100, more in blocks of 100 | Set by your contract |
| All PDF tools, OAuth2 / OIDC single sign-on, server certificate signing | Yes | Yes | Yes |
| Monthly processing allowance (automation, AI and API calls) | 1,000 units | 2,500 units | Unlimited |
| External database and clustering | - | Yes | Yes |
| S3 or database file storage | - | Yes | Yes |
| Encryption at rest for stored files | - | Yes | Yes |
| Prometheus metrics (usage monitoring) | - | Yes | Yes |
| Custom PDF metadata | - | Yes | Yes |
| SAML2 single sign-on | - | - | Yes |
| SCIM user provisioning | - | - | Yes |
| Audit logging and Usage Analytics | - | - | Yes |
| Database backup and import email notifications | - | - | Yes |
| Offline activation with a certificate file | - | - | Yes |
The Team and Enterprise plans need a login-capable build (latest, latest-fat or Stirling-PDF-with-login.jar). The latest-ultra-lite image and the other JARs have no plans or admin settings.
User limits#
- Free plan: 5 users. A server upgraded from V1 keeps its existing user count as the limit if that is higher.
- Team plan: the users you bought on stirling.com.
- Enterprise plan: the licence sets the limit.
When the server reaches its limit, no more users can be added and admins see a notice such as Team plan needed or Your server has more users than your plan covers. To add users on the Team plan, buy another block of 100 on stirling.com. See Upgrade to Team or add users.
Get the Team or Enterprise plan#
Only the organization owner can link the server or activate a licence, and login must be on.
Team plan: link the server to your account on stirling.com, then sign up for the Team plan there. See Connect to Stirling Cloud and Upgrade to Team or add users.
Enterprise plan: book a demo or email [email protected]. You get a licence key, or a certificate file for servers without internet access.
Activating your Enterprise license#
- Sign in as the organization owner and open Settings → Workspace → Usage & Billing.
- Select Got a license key or certificate file?
- Choose License Key and paste your key, or choose Certificate File, select Choose License File and pick your
.licor.certfile. - Select Save Changes.
The plan applies straight away, with no restart. Replacing an existing key can't be undone, so keep a copy of it.
A licence key is checked online. A certificate file works offline: it must start with -----BEGIN LICENSE FILE-----, and the server saves it in configs/, keeping a copy of any file it replaces in configs/backup/.
Set the licence in settings.yml#
For scripted deployments, set the key and restart:
premium:
enabled: true
key: your-licence-keyPREMIUM_ENABLED=true
PREMIUM_KEY=your-licence-keyFor a certificate file, put it in the config folder and point to it with the file: prefix, for example key: file:configs/licence.lic.
Billing and the organization owner#
- Team plan: manage the plan, users, invoices and cancelling on stirling.com. See Plans, credits and billing.
- A licence bought in the app: on Settings → Workspace → Usage & Billing, select Manage on your current plan to open the Stripe billing portal. Stripe may email you a sign-in link first.
Only the organization owner can manage Usage & Billing and the link to Stirling Cloud. The owner is the first admin account. To hand it over, open Settings → Workspace → Users, set another user's role to Org Owner and confirm Transfer ownership. The new owner becomes an admin.