Skip to content

Billing

Colony Cloud billing is per tenant. Each tenant has its own plan, its own subscription and its own Worker count, and the organization-level pages give you the overview, the invoice history and the list of tenants.

Open Account → Billing (/account/billing) to start.

The Billing overview shows:

  • Billing status — active, past due or delinquent, or No subscription when nothing is billed yet.
  • Tenants — how many tenants your organization has.
  • Month-to-date estimate — the running estimate for the current month.
  • Upcoming invoice — the amount and the date it is due, when one is scheduled.
  • Payment method — On file or Not set.

Three buttons sit below the figures:

  • View tenants opens the Tenants list.
  • Invoice history opens the Invoices list.
  • Manage payment method opens the billing portal, where you update the card on file.

If your organization has no billing account yet, the page says so and Manage payment method stays disabled. Contact support to get one set up.

When the billing status is past due or delinquent, a Payment past due banner appears above the figures. Select Update payment method in the banner to open the billing portal and replace the card.

Invoice history lists past invoices, with these columns:

ColumnWhat it shows
Invoice numberThe invoice number, when one has been assigned.
DateWhen the invoice was created.
AmountThe invoice total.
Statuspaid, open, void, uncollectible or payment_failed.
ActionsPDF and View links, shown when they are available for that invoice.

Select Load more below the table to page further back.

The Tenants list has one row per tenant. Each row shows:

  • The tier (Open, Solo, Team, Business or Enterprise) and the subscription status.
  • Cancels at period end, when a cancellation is pending.
  • Budget exhausted or Budget warning, when the tenant’s budget needs attention.
  • The projected monthly cost, or Free, and the current burn rate per day.

Select a row to open the tenant’s billing detail. Set the tenant ceiling and the repo caps in the Budgets section of Operations → Settings (/operations/settings). The old /settings/tenants/:tenantId/budgets link redirects to the tenant’s billing detail (/account/billing/tenants/:tenantId), which is not a budget editor. For spend observability, see Cost & Budget.

The detail page opens with the Current plan, the subscription status and the current billing period.

Change plan shows a card for each self-serve plan: Open, Solo and Team.

Organizations on a contract don’t see Change plan. Their plan is set by their agreement.

  • With no subscription, select Upgrade to Solo or Upgrade to Team. You continue through checkout.
  • With a subscription, select Switch to Solo or Switch to Team. A confirmation dialog opens. Its confirm button carries the same name as the action, for example Switch to Team, and its cancel button is No, go back. After you confirm, the change takes effect immediately, with proration.
  • To go back to Open from a paid plan, cancel the subscription (see below). Downgrade is disabled on the Open card.

Business and Enterprise aren’t self-serve. Email sales@runcolony.com.

A tenant with a subscription has a Subscription section.

  • Cancel subscription opens a confirmation dialog. Confirm with Cancel subscription, or select No, go back to keep things as they are. Once confirmed, the subscription stays active until the end of the current billing period. After that, the subscription is canceled. If every enabled repository is public, or none is enabled, the tenant moves to Open. Otherwise it is archived 7 days later.
  • While a cancellation is pending, the section shows the cancellation date and a Reactivate subscription button. Select it to keep the subscription.

Both actions are self-serve. You do not need to contact support.

Tenants on Team, Business or Enterprise with a subscription also get a Worker configuration section. Use the − and + controls to set the Worker count. The page shows an estimated monthly cost for the count you have set, and updates it as you change the count.

  • Apply is disabled until the count you have set differs from the current count.
  • Selecting Apply opens a confirmation dialog titled Change workers from {current} to {new}. It shows your estimated monthly Worker cost before and after the change, and notes that changes are prorated to the current billing period.
  • Select Update workers to confirm, or No, go back to leave the count as it is.
  • If you set the count to 0 while Workers are running, the dialog is styled as a stronger warning.
  • On success, a Worker count updated toast appears and the page reloads the tenant. If the change fails, the error message from the API appears as an error toast and the Worker count is not changed.

Workers are billed per Worker at graduated rates. The Worker configuration section shows the rates and your estimate.

For what Workers do and how to run your own, see Workers.

Changes to the Worker count are prorated to the current billing period, and so are pool-size changes made on Operations → Fleet. After a resize on Fleet, the confirmation reads either Pool size updated — $X prorated to this period or Pool size updated — $X credited to your next invoice.