---
title: "Plans & billing"
description: "Manage your Alpacon plan from the console. Learn what happens at a plan limit, how upgrading works, and what happens if a renewal charge fails or you cancel."
---

> Full documentation index: https://docs.alpacax.com/llms.txt

# Plans & billing

Alpacon Cloud offers Free, Essentials, and Enterprise plans. This page covers plan limits, usage, upgrades, renewal charges, and cancellation; use Payment and History for billing details and records.

## Plan types and limits

See [defaults and limits](/reference/limits/) for plan limits.

## Where to manage your plan

The **Billing** page lives inside workspace settings.

1. In the left sidebar, click **Workspace settings**. This entry is only shown to Staff and Superuser members.
2. Open **Billing**. The page opens on its **Overview** tab.

The page has three tabs:

- **Overview**: your current plan, this period's usage, and the estimated cost.
- **Payment**: the cards this workspace is charged on, and the billing details behind them.
- **History**: the invoices, payments, and credits recorded for this workspace.

All three need billing permission (Staff and Superuser). Without it, **Billing** isn't listed in settings at all, and opening one of its pages by URL says only that you don't have permission to view billing information.

### What the Overview page shows

- **Current plan**: your plan name, a **Trial** badge during a trial, and a **Fixed term** tag on a contract. **Upgrade** (on Free) or **View plans** (on a paid plan) opens the upgrade panel over the page you're already on. Under the name, a subscription shows **Renews on** (**Trial ends** during a trial) and the **Billing period**; a contract shows a single **Contract term** stat covering the whole term, with the days left as its caption. A workspace billed through a company account also carries a line saying it's billed to that company, with a **Contact your account manager** link.
- **Estimated next charge**: what the workspace is due to pay next and the date it's charged. It appears once there's a subscription with a next billing date. A prepaid contract shows **Next payment** as **None** instead, captioned with the date it's paid through. **Available credit** joins that row whenever the workspace holds any; credit comes off the next invoice on its own.
- **Usage this period**: a tile each for **Active users**, **Active servers**, **Websh session usage time**, and **FTP file transfer volume**, every title linking to the matching page for details. Where the plan sets a limit, the tile reads usage against that limit with a bar, and the line under it gives the share used, such as "45% used". From 80% of the limit the bar turns amber and the line says you're close to the limit; once usage goes over the limit, the bar turns red and the line says so. A tile with no limit keeps an empty bar, and its line says why: **Unlimited**, or **Unlimited (fair use)** for usage that's measured but never blocked. If the plan sets no limit on any of the four, the figures read as one row and the section notes once that the plan has no usage limits. Websh time reads in hours, such as 12.5 h.
- **Estimated month-to-date cost**: a per-service breakdown with any overage, plus subtotal, any promotional discount, credit applied, tax, and total. A prepaid contract is paid in full for its term, so this section isn't shown for one.

The **Billing period** these figures cover (**Contract term** on a contract) is shown under the plan name, and again beside the usage heading. The cost is an estimate. The final invoice is issued at the end of each billing period and may differ.

On a monthly plan, each renewal bills you for the server count you have at that moment—the capacity you're reserving for the period ahead. Removing servers mid-period doesn't refund what you already paid; it only lowers what's billed at the next renewal. If your server count runs above what you're paying for at any point in the period, that overage is settled once, at the following renewal, based on how long you ran above your reserved count over the whole period rather than a single snapshot. Annual plans don't add overage automatically this way—if you need more capacity than your annual term covers, your account manager arranges it.

## Where to see your workspace's usage

Every member of the workspace can open the Usage page at `/<workspace>/usage/`, whatever their role. Unlike the Billing pages above, it needs no billing permission and it's read-only. Open it from the **See usage** link in a limit dialog or from the command palette (search for Usage).

The **Plan limits** section has one tile for each limit your plan can set: **Servers**, **Members**, **Applications**, **Websh time**, **WebFTP transfer volume**, and **Websh sharing time**. Each tile shows what the workspace has used against its limit, with a bar and a line under it that follow the state Alpacon reports:

- **Normal**: the bar keeps its default color, and the line gives the share used, such as "40% used".
- **Near the limit**: the bar turns amber and the line reads **Near limit**.
- **At the limit**: the bar turns red and the line says what you can't do. For servers, members, and applications, it tells you to remove one or upgrade to add more; for a monthly allowance, it says new use is blocked until the allowance resets. What that blocks is described under [What happens at a limit or a gate](#what-happens-at-a-limit-or-a-gate).

Servers, members, and applications are counts. They have no reset date, because adding more is allowed again as soon as you remove one or upgrade. Websh time, WebFTP transfer volume, and Websh sharing time are monthly allowances, and the line under each of their tiles shows the date the allowance resets, after the state when there is one. Websh time and Websh sharing time read in hours.

A tile with no limit keeps an empty bar, and its line says why: **Unlimited**, or, on Essentials, **Unlimited (fair use)** for Websh time and WebFTP transfer volume, which are measured and never blocked. If the plan sets no limit on any item, the figures read as one row and the section notes once that the plan has no usage limits.

Below the limits, **Other usage this period** lists usage that is measured for reference only and never blocks anything: **AI command verifications**, **Port forwarding time**, and **Editor time**, each with the date the period started.

## What happens at a limit or a gate

When you reach a plan limit or open a feature your plan doesn't include, Alpacon shows a dialog naming the plan that unlocks it, summarizing what you gain, and linking to the pricing page. Continuing from that dialog opens the upgrade panel over the page you were on. Nothing opens a new browser tab and you don't lose your place. The action you attempted isn't completed until the plan is upgraded.

The dialog doesn't show your numbers. To see what the workspace has used and when a monthly allowance resets, follow its **See usage** link to the [Usage page](#where-to-see-your-workspaces-usage).

What the panel offers depends on how the workspace is billed and on what you're allowed to do:

| What the panel says              | When you see it                                                                                                                                                               |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Start your free trial**        | You manage billing and the workspace hasn't used its trial. Every limit lifts for the length of the trial, and nothing is charged until it ends.                                |
| **Upgrade this workspace**       | You manage billing and the trial is already spent. The new limits apply as soon as the charge goes through.                                                                    |
| **Ask an admin to upgrade**      | You don't manage billing. The panel names the members who do and gives you a link to email them. If nobody in the workspace manages billing, it points you to support instead. |
| **Talk to your account manager** | The workspace is billed under a contract. Its limits are agreed there rather than bought from the console, so there's no checkout.                                             |
| **Contact us for a bigger plan** | The plan you'd need isn't sold from the console. Enterprise is arranged with us directly—write to [support@alpacax.com](mailto:support@alpacax.com).                           |

You can open the same panel yourself from the Overview page—**Upgrade** on Free, **View plans** on a paid plan. Started that way it opens on the plan summary; reached from a limit it opens straight on card entry, because the dialog already asked.

The dialog you see at a limit, as opposed to a locked feature, also offers **Talk to us** beside the upgrade button, which reaches our team instead of upgrading from the console. When there's nothing you can buy from the console, because you don't manage billing or the plan you'd need is arranged with us directly, it's the dialog's only way forward.

The table below is qualitative. The Free plan's numbers are under [Free plan limits](#free-plan-limits); for paid plans' numbers and the features each plan includes, see the [pricing page](https://www.alpacax.com/alpacon/pricing).

### Plan limits

| Limit                                         | What happens when you reach it                                                        | Raised by         |
| --------------------------------------------- | ------------------------------------------------------------------------------------- | ----------------- |
| Members in a workspace                        | Inviting another member shows an upgrade dialog, and the member isn't added.          | Any paid plan     |
| Registered servers                            | Registering another server shows an upgrade dialog, and the server isn't added.       | Any paid plan     |
| Applications (identities for automation)      | Adding another application shows an upgrade dialog, and the application isn't created. | Any paid plan     |
| Workspaces you can belong to                 | On Free you can have one workspace; adding another needs an upgrade.               | Any paid plan     |
| Websh session usage time, FTP transfer volume | On Free, starting a new terminal session or transfer shows an upgrade dialog once the period's allowance is used up. Paid plans measure both without blocking. | Any paid plan     |
| Activity log retention window                 | How far back activity history reaches depends on your plan.                            | Higher plans      |

### Free plan limits

On the Free plan:

- **Servers**: 3.
- **Members**: 3, pending invitations included.
- **Applications**: 1.
- **Workspaces**: one. While you belong to a Free workspace, adding another needs an upgrade.
- **Websh session usage time**: 30 hours per usage period. Once they're used up, starting a new terminal session is blocked until the next period starts. A session already open keeps running.
- **WebFTP transfer volume**: 100 MB per usage period. Once it's used up, starting a new upload or download is blocked until the next period starts. A transfer already in progress completes.

The usage period is monthly, and the Overview page shows the current one.

Servers, members, and applications are counts, and a count limit only stops you from adding more. A workspace that already has more than Free allows, such as servers registered during a paid plan, a trial, or under an earlier, higher limit, keeps everything it has, and all of it keeps working. Adding another is blocked until you're back under the limit or you upgrade. Reinstalling the agent on a server registers it as a new server, so in a workspace at or over the server limit, delete the server's old entry first.

On Essentials, Websh session usage time and WebFTP transfer volume are fair use: both are measured and shown on the Overview page, but never blocked. Enterprise has no limit on either.

### Features by plan

| Feature                                                            | On Free                                                        | Unlocks with        |
| ----------------------------------------------------------------- | ------------------------------------------------------------- | ------------------- |
| Reading a Web terminal recording and searching typed text across sessions | The list shows your own sessions; recordings show an upgrade prompt, and typed-text search isn't offered | Essentials or higher |
| File transfer history for WebFTP                                   | Prompts an upgrade                                            | Essentials or higher |
| Activity log | Prompts an upgrade; system logs are available on every plan | Essentials or higher |
| [External access](/use/audit/governance/external-access/) evidence export (review, coverage and the summary work on every plan) | Prompts an upgrade | Essentials or higher |
| Assigning a work session to another user | The assignee is locked to you; the form shows an upgrade prompt | Essentials or higher |
| Other members' work sessions, commands, sudo records, and Web terminal sessions | Lists show only your own records from the last 7 days, for every role including Superuser | Essentials (120 days) or Enterprise (365 days) |
| Session sharing in Websh                                           | Sharing shows an upgrade prompt                               | Essentials or higher |
| AI session analysis | Analysis details prompt an upgrade | Essentials or higher |
| Threat analysis (MITRE ATT&CK heatmap) | Prompts an upgrade | Enterprise |
| Websh AI analysis results | Prompts an upgrade | Essentials or higher |
| API access tokens (API tokens)                               | Creating a token prompts an upgrade                          | Essentials or higher |
| Slack notifications and webhooks | Prompts an upgrade | Essentials or higher |
| Metrics extension (server charts—CPU, memory, disk, disk I/O, network—and metric alert rules) | Not available | Essentials or higher |
| Enterprise SSO (Okta Integration Network or SAML IdP)                                         | Not available                                                | Enterprise          |
| Other extensions (IP, DNS, Proxy, Private SSL, Package mirrors, Power control) | Not available                                  | Enterprise          |

A Slack installation made on a paid plan keeps posting after a downgrade.

## Paying for an upgrade

For card entry during an upgrade, see [Manage payment details](/use/workspace/plans-billing/payment/).

## If a renewal charge fails

If a scheduled charge doesn't go through, a banner appears at the top of the Overview page. It says whether the card was declined or we couldn't calculate tax from your billing address, with a button straight to fixing it (**Manage cards** or **Fix billing address**) and a **Retry payment** button that tries again right there.

We also retry automatically—on a monthly plan, on day 1, day 3, and day 7 after the failed charge (day 3, 7, and 14 on an annual plan)—and email you at each stage: when the first attempt fails, again before the last retry, and once more if the subscription ends up paused. If the final retry still fails, the subscription is paused and the workspace moves to the Free plan with everything it already has (see [Free plan limits](#free-plan-limits)); fixing your card or billing address before then keeps it on its current plan.

## Cancelling a subscription

**Cancel subscription** sits at the bottom of the Overview page, for any self-serve paid plan that isn't already on Free or under a contract. Only members who manage billing see it. The confirmation asks you to type **Cancel subscription** into a field, and the button stays disabled until what you typed matches. Cancelling is immediate: the workspace returns to the Free plan right away, not at the end of the current billing period, and nothing renews after that.

When a workspace leaves Enterprise for Essentials or Free, **MFA timeout** returns to 1 hour and **Sensitive action MFA timeout** to 15 minutes; no actions remain selected under **Require MFA for**. When any of these values change, every Superuser gets one **Critical** notice in the in-app feed and by email that lists each changed setting with its previous value and its new default. The activity log also records the previous and new values. Alpacon doesn't restore the previous values on its own: after upgrading to Enterprise again, a Superuser sets them back under **Policies > Authentication**. The notice and the activity log are both best-effort, so if both fail, the previous values are lost; the downgrade itself still completes.

What you already paid for this period isn't refunded for the days left in it. If your server count ran above what you're paying for at any point in the period, that's settled once, at the moment you cancel, on the same whole-period basis a normal renewal uses—so most cancellations add nothing further, and only a fleet that ran well above its reserved count for much of the period is charged more.

Cancelling is never blocked by usage. A workspace with more members or servers than Free allows cancels just the same, and everything it has keeps working on Free; you can't add more of what's over a limit until you're back under it or you upgrade again. During a trial, the section and its button read **Cancel trial** instead, and that is what you type to confirm. It ends the trial immediately, and nothing is charged. A trial we set up for you has no cancel button; it ends on its end date.

A workspace billed through a company account or under a contract doesn't cancel this way—reach your account manager instead.

## Payment and history

See [Manage payment details](/use/workspace/plans-billing/payment/) or [View invoices and payment history](/use/workspace/plans-billing/history/).

## Who can manage billing

- **See the plan, usage, and estimated cost**: Staff and Superuser members. Without billing permission **Billing** isn't shown in settings, and opening its **Overview** tab by URL only says you can't view billing information. The [Usage page](#where-to-see-your-workspaces-usage) is open to every member.
- **Manage cards, billing details, invoices, and payments**: Staff and Superuser members. The **Payment** and **History** tabs don't appear for anyone else.
- **Change the plan**: Staff and Superuser members. Anyone else who reaches a limit is shown the members who can change it, with a link to email them, and is pointed to support if the workspace has none.

## Self-hosted deployments

Plan, usage, and billing apply to Alpacon Cloud. Self-hosted deployments have no payment service, so the **Billing** menu, the usage meters, and the cost estimate aren't shown, the Usage page says the deployment has no plan limits to show, and an upgrade prompt sends you to us rather than to a checkout.

## Related docs

- [Manage workspace settings](/use/workspace/settings/)
- [Invite team members](/use/iam/users/add/)
- [Get a workspace](/use/workspace/create/)
- [Alpacon pricing](https://www.alpacax.com/alpacon/pricing)

Source: https://docs.alpacax.com/use/workspace/plans-billing/
