Settings & Billing
Manage your Matrix OS plan, computer, billing, and AI Chat credit after signup. Review trial eligibility, payments, and computer availability.
Maintained by the Matrix OS team. Product instructions are updated with the supported workflow.
Settings is where you manage the explicit parts of Matrix: billing plan, computer capacity, location, integrations, and account controls. Open it from the top-right user menu or from the sidebar in any shell mode.
First-time setup
Plan and region selection happens during initial provisioning. See Quickstart for that flow. This page covers what you can change after your Matrix computer is running.
Billing
The Billing section shows your current computer's plan and opens the Stripe billing portal for invoices, payment methods, and plan changes. Each Matrix computer has its own Stripe subscription under your existing Stripe customer, so billing or canceling one computer does not change another computer's plan.
Plans and compute tiers
Each plan maps to a dedicated Matrix computer. The three available tiers are:
| Plan | Monthly list price | Germany and Finland capacity | US capacity |
|---|---|---|---|
| Starter | $20 | 2 vCPU, 4 GB RAM, 80 GB disk | 3 vCPU, 4 GB RAM, 80 GB disk |
| Builder | $100 | 8 vCPU, 16 GB RAM, 320 GB disk | 4 vCPU, 8 GB RAM, 160 GB disk |
| Max | $200 | 12 vCPU, 24 GB RAM, 480 GB disk | 8 vCPU, 16 GB RAM, 240 GB disk |
Builder is the default selection and suits most developers running a coding agent alongside a dev server. Choose Max for parallel agent workers, heavy builds, or multiple long-lived processes.
Prices shown here must be verified
The prices above come from the source-of-truth billing constants in the codebase. Confirm current pricing against the live checkout screen or the matrix-os.com pricing page before making a decision.
New Checkout sessions use monthly billing. Existing annual subscriptions remain supported and keep their attached Stripe price.
Fourteen-day trial for your first computer
Your first primary computer is eligible for one fourteen-day free trial on Starter, Builder, or Max when the offer is enabled. A card is required in Stripe Checkout, but you pay $0 today. The Billing screen shows the exact recurring Stripe price when it is available, the trial-ending date, and the cancellation deadline.
Eligibility belongs to the Matrix account, not an email alias, card, plan, or computer. Previous subscribers cannot start another trial. Additional computers and subsequent subscriptions begin billing immediately.
Matrix may prepare the selected computer while Checkout is open, but it authorizes access only after a verified Stripe webhook projects the subscription as trialing. Checkout return parameters never grant runtime access. If early preparation is not available, Checkout and billing continue normally, and Matrix automatically starts or resumes provisioning after authorization. There is no second provisioning choice or start button after payment.
Active plan view
When billing is active, the Billing section shows:
- Plan name — Starter, Builder, or Max.
- Status — Active, Past due, canceled, or a grace-period label with the end date.
- Billing — the recurring price and interval attached to this subscription. Legacy customers see their legacy price, not today's list price.
- Location — the actual provider-neutral location of the current computer, such as Ashburn, Virginia, Falkenstein, Germany, or Helsinki, Finland.
During a trial, the shared shell also shows the days remaining, upcoming price and charge date, and a link to the Stripe customer portal. The reminder becomes more prominent during the final three days.
Starter, Builder, and Max each include exactly one computer. The plan controls that computer's strength; it does not grant shared slots that another computer can consume.
Adding another computer
Open Runtime and choose New computer. Matrix reuses the same plan, region, billing interval, and Checkout steps as first-time setup:
- Name the computer.
- Choose Starter, Builder, or Max and a region.
- Review monthly billing.
- Complete a new Stripe Checkout subscription.
- Wait for the signed Stripe webhook to activate that runtime slot, then continue through normal provisioning.
Checkout reuses your existing Stripe customer, but creates an independent full subscription for the new computer. Matrix does not purchase computer capacity through a Customer Portal subscription-update flow.
Additional computers are not trial-eligible and start billing immediately.
Billing portal
In Web Desktop and Web Canvas, choose Open billing portal. In Electron Desktop, open Settings → Billing and choose Manage billing. Electron Desktop uses your signed-in Matrix account to open the billing portal in your default browser. From there you can:
- Manage an existing Starter, Builder, or Max subscription without deleting data or machines.
- View invoices and receipts.
- Update your payment method or billing email.
- Apply coupons.
- Cancel — access stays active through the billing cycle and the configured grace window.
Existing customers can still view receipts and manage payment settings when a subscription is overdue, unpaid, or canceled. Runtime access and access to billing records are separate.
After making changes in the portal, return to Electron Desktop and select Refresh to reload your billing status. If the portal cannot open, Settings shows an error and lets you retry.
Billing management remains visible while availability is checked. If a portal is not available for your account yet, the button is disabled with an explanation.
Internally managed accounts
Portal access follows the billing customer linked to your signed-in Matrix account. A support override or internally granted runtime plan does not remove access to your existing invoices. If no billing customer is linked, contact the Matrix team for billing help.
Canceling
Cancel from the Stripe billing portal, not from the shell. Canceling a trial keeps access available until Stripe's displayed trial_end; no charge is made when cancellation completes before that deadline. Access is gated when the trial ends, and Matrix retains the stopped VPS and its owner data rather than deleting it.
For established paid subscriptions, a recoverable renewal failure keeps the existing three-day grace period. The first payment failure immediately after a trial does not receive that grace: access pauses at once, and the VPS is scheduled to power off 24 hours later. Updating the card and completing payment restores access automatically and wakes a suspended computer.
Compute and region
When you do not yet have an active plan, or when you are re-provisioning, the Billing section shows the computer and region pickers.
Choosing a computer
The computer picker shows the three tiers (Starter, Builder, Max) with their vCPU, RAM, and disk specs inline. Builder is pre-highlighted as the recommended option.
Choosing a region
Matrix selects the closest available location from the browser's time zone. New computers can be provisioned in five locations:
- Germany — Falkenstein and Nuremberg
- Finland — Helsinki
- United States — Ashburn, Virginia and Hillsboro, Oregon
Region selection determines where your Matrix computer is provisioned. You cannot change the region of an existing machine without reprovisioning.
Matrix AI Chat credit
See Matrix AI models for the Workers AI catalog, the default model for new chats, and model availability during rollout.
In updated Web Canvas, Web Desktop, and Electron Desktop builds, open Settings → Agents & providers and inspect Matrix AI for the selected computer.
An update is being prepared to provide eligible owners with a one-time USD 5 Matrix AI starter credit per owner after their primary Matrix computer activates successfully. This credit has no expiry. Owners who already received starter credit do not receive a second grant or a top-up. Reinstalling a computer or retrying activation does not issue another starter credit or reset the amount already used. Starter credit does not cover your computer plan payment, and model access still depends on current service availability and spendable Chat credit. This update has not yet been rolled out to all users.
Chat credit available is the amount currently spendable on ordinary Matrix AI Chat. It excludes speech-only allowance and expired promotional credit. The remaining monthly budget can further limit what you can spend. Older Gateway versions also exclude credit held while usage is being confirmed.
Upcoming update: no wallet-credit reservations
New managed Matrix AI and Speech requests will keep wallet credit available while they run. Successful requests will charge their actual usage once, within the applicable credit and usage limits. Failures, cancellation, and unconfirmed usage will be covered by Matrix; they will not create a debt or take credit from a later top-up. Existing expired Chat and Speech holds will be released with their history preserved. Speech monthly allowances and request limits still apply, and any temporary allowance usage is separate from wallet credit. This behavior requires the Gateway update; this documentation update does not deploy it.
Choose Usage history to review recorded credit additions, model usage, and adjustments for that computer. History describes past activity; it does not confirm current spendable Chat credit. It can remain available while the current credit check is unavailable.
Chat credit unavailable means Matrix cannot currently confirm the spendable amount. It does not mean the balance is zero. If a value is marked as last confirmed, treat it as an earlier observation. Use Refresh provider status (↻) to check the selected computer again. If the unavailable state persists, contact the Matrix team with the computer name, the displayed status, and your app version.
If support identifies missing Chat configuration, they may recommend a scoped Matrix OS repair update for your computer. Follow the update and restart steps provided by support, and finish active work before restarting. After the update and any required restart complete, reload Web Canvas or Web Desktop, or reopen Electron Desktop, then choose Refresh provider status. These repair updates preserve your files and conversations and do not grant extra credit.
Credit availability and model readiness are separate checks. A displayed balance does not guarantee that the selected model can run; Chat checks current access and availability when you send. If an older build shows Credit reserved after a failed request, contact support with your computer name and the approximate failure time. For Monthly budget reached, contact your workspace administrator or support. Follow the displayed recovery action for a confirmed credit shortage or unavailable model.
Model availability
The managed Matrix AI model list can change when a provider changes prices or retires a model. If your selected model is unavailable, refresh provider status and choose an available model in Chat. If no managed models are available after refreshing, contact the Matrix team with the displayed status and the approximate time.
Expired request holds
Older Chat and Speech requests can still have wallet credit reserved while their usage is unknown. Elapsed time alone does not prove that the request had no cost. The upcoming update releases these expired holds while retaining the original request and accounting records. Any later confirmed cost for a released request is covered by Matrix. This does not issue new credit, reset successful past usage, or make an unavailable service ready.
If support confirms that a reviewed charge waiver is available for your request, it can release the original held funding without granting extra credit. The request and audit records remain, and provider usage stays unknown until verified. Matrix assumes any later verified cost for that waived request; it cannot charge you again for the same request. A waiver does not automatically clear other holds or make a model ready.
Other Settings sections
Visible sections
Settings includes Appearance, Agents & providers, Integrations, Billing, and System. Available sections can vary with the installed build and presentation.
Appearance
Control the shell color theme and visual preferences.
Integrations
Connect external services. Matrix keeps provider credentials platform-side and requests permission before acting through a connected service. Common integrations include Discord, Slack, Gmail, Calendar, and Drive. For repository work, select GitHub Developer in Connect Apps to configure owner-controlled GitHub access for the selected computer.
System
Runtime status, restart controls, and system-level preferences for your Matrix computer.
Next steps
Quickstart
If you have not provisioned yet, the Quickstart walks through plan selection, billing, and first boot.
Matrix CLI
Attach to shell sessions and run coding agents from your local terminal.
Account export and deletion
See Account data and deletion for the planned five-day grace period, download and migration options, billing cancellation, and ownership transfer requirements.
How is this guide?
Matrix AI models
Explore managed Workers AI models, how to choose a model, and how ordinary Chat and Matrix Bot share Matrix AI credit.
Account data and deletion
Learn how to export or migrate your Matrix OS data, request account deletion, and understand the five-day grace period before deletion proceeds.