Self-hosted server

Connect to Stirling Cloud

Link your server to your Stirling Cloud account to use its plan, users and processing allowance. Linking is optional on the Enterprise plan.

Linking gives the server:

  • The Team plan, when your account has it.
  • Your account's user allowance.
  • Your account's processing allowance, in place of the server's own 1,000 units a month.
  • Access to Stirling Cloud AI. See Use Stirling Cloud AI from your server.

Processing allowance#

Using the tools by hand never counts. These do:

Work Counted as
Processor pipelines and policies Automation
Pipeline API steps and MCP tool calls Automation
AI tools AI
PDF tool calls made with an API key API

An unlinked server gets 1,000 units a month. A file uses one unit per 25 pages or per 5 MB, whichever gives more. No file uses more than 1,000 units.

When the units run out, automation, AI and API calls stop until the next month. Manual tools keep working.

A linked server uses the allowance and unit rules of your Stirling Cloud account instead. The Team plan raises the allowance to 2,500 units a month.

Connect your server#

  1. Make sure login is on, then sign in to your server as the organization owner.
  2. Open Settings → Workspace → Account connection and select Connect your Stirling account.
  3. Sign in to Stirling Cloud as the account owner.
  4. On Connect this server?, check that the Address is your server, tick I recognise this address and want to connect it to my team and select Connect server.
  5. Back on your server, check the plan and allowance under Settings → Workspace → Usage & Billing.

Only the account owner can approve a server. If the address doesn't use HTTPS, Stirling Cloud shows Not an encrypted address.

What is sent#

Your server sends its user count, usage totals and instance details every 24 hours and receives its plan, Team allowance and processing credits.

When you connect, the server sends its name and address. It then syncs straight away and every 24 hours: it sends its user count, processing-unit totals and instance ID, and gets back your account's plan, user allowance and remaining credits. No PDFs, filenames or user lists are sent.

If the server can't confirm its plan with Stirling Cloud for 3 days, the Team plan features and processing that come from the link pause until it reconnects. Installed licence keys and your data are not affected.

Manage or disconnect#

  • Account connection lists this server and the other servers connected to your account. Manage on stirling.com opens them in Stirling Cloud, where the account owner can rename or remove them (see Teams).
  • Disconnect this instance stops using your account's plan and allowance. Files on the server are kept.