Settings & Billing
Manage your plan, compute tier, region, and billing portal after signup.
Settings is where you manage the explicit parts of Matrix: billing plan, compute tier, region, 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 plan and opens the Stripe billing portal for invoices, payment methods, and plan changes.
Plans and compute tiers
Each plan maps to a dedicated Matrix computer. The three available tiers are:
| Plan | vCPU | RAM | Disk | Monthly | Annual |
|---|---|---|---|---|---|
| Starter | 2 | 4 GB | 80 GB | $14 | $140 |
| Builder | 4 | 8 GB | 160 GB | $19 | $190 |
| Max | 12 | 24 GB | 480 GB | $49 | $490 |
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.
Annual billing is available at checkout — the order summary panel offers a monthly/annual toggle before you pay.
Active plan view
When billing is active, the Billing section shows:
- Plan name — Starter, Builder, or Max.
- Status — Active, Trialing, Past due, or a grace-period label with the end date.
- Computers — how many Matrix computers your plan includes, plus any add-on slots.
- Machine — the size and spec of your default Matrix computer.
- Add-ons — extra machines or storage attached to your account.
Billing portal
The "Open billing portal" button launches the Stripe customer portal in a new tab. From there you can:
- Switch between Starter, Builder, and Max without deleting data or machines.
- Add or remove extra computer slots.
- 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.
Internally managed accounts
If your account is managed by the Matrix team (internal plan), the billing portal button is disabled. Plan changes and receipts are handled by the team directly.
Canceling
Cancel from the Stripe billing portal, not from the shell. Your Matrix computer and owner data are not deleted automatically. Access remains while billing is active and continues through the configured three-day grace window after the period ends.
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
The region picker groups locations by geography. The nearest region is selected automatically based on your time zone. Available regions are:
- Europe — Falkenstein, Germany and Nuremberg, Germany
- Americas — US East and US West
- Asia Pacific — (additional regions as they become available)
Region selection determines where your Matrix computer is provisioned. You cannot change the region of an existing machine without reprovisioning.
Other Settings sections
Visible sections
The Settings nav currently shows Appearance, Integrations, Billing, and System. Agent, Channels, Skills, Security, Cron, and Plugins sections exist in the codebase but are hidden pending further development.
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 GitHub, Discord, Slack, Gmail, Calendar, and Drive.
System
Runtime status, restart controls, and system-level preferences for your Matrix computer.
Next steps
How is this guide?