Runtimes

Cyrus offers two runtime modes that determine where your Cyrus instance runs. Which runtimes are available, and whether you can switch between them, depends on your plan (see Runtime availability by plan below).

​

Runtime types

​

Self-hosted

With self-hosted runtime, Cyrus runs locally on your machine. This gives you full control over the runtime environment. Benefits:

• Full control over the runtime environment
• Data stays on your machine
• Works offline once started

Requirements:

• Local Cyrus CLI installation
• Must run the CLI to enable agent functionality

​

Cloud-hosted

With cloud-hosted runtime, Cyrus runs on our managed infrastructure. This is the simplest option as there’s nothing to install or maintain on your end. Benefits:

• No local installation required
• Automatic updates and maintenance
• Always available without manual startup

​

Runtime availability by plan

Not every plan can run on every runtime. The Team plan can run either self-hosted or cloud-hosted (and can switch between them); the Pro plan is self-hosted only. Cloud-hosted runtime is available only on the Team plan.

​

Upgrading to the Team plan

To move from Pro (self-hosted) to cloud-hosted, upgrade to the Team plan. Open the Usage section of your workspace settings and choose to upgrade. The Team plan unlocks cloud-hosted runtime, after which you can switch runtimes from the dashboard at any time.

​

How to switch runtimes

On the Team plan, admin users can switch their workspace’s runtime at any time. The runtime badge is located in the top-right header, next to the user avatar.

​

Step 1: Locate the runtime badge

In the dashboard header, you’ll see the current runtime displayed as a badge next to your avatar. It will show either “self-hosted” or “cloud-hosted” with an icon.

​

Step 2: Open the switch dialog

Click on the runtime badge to open the runtime switch dialog. This dialog explains what will happen when you switch runtimes. The dialog will display:

• Your current runtime
• What will change after switching
• Confirmation that your plan pricing won’t change

​

Step 3: Confirm the switch

After clicking to proceed, you’ll see a confirmation dialog with an important warning. Click the confirmation button to proceed with the switch.

​

After switching

Depending on your target runtime:

• To Cloud-Hosted: Your runtime will be provisioned on our infrastructure. This typically takes a few moments.
• To Self-Hosted: You’ll be guided through installing and authenticating the Cyrus CLI on your machine.

​

Who can switch runtimes

• Admin users can switch runtimes for their workspace
• Team plans can switch freely between self-hosted and cloud-hosted runtime
• Pro plans are self-hosted only and cannot switch to cloud-hosted. Upgrade to Team for cloud hosting
• Enterprise plans have fixed runtime configurations managed by your organization

​

Resubscribing

If your subscription has lapsed and you resubscribe, the available options match the current pricing page: Pro is self-hosted, and cloud-hosted runtime comes with the Team plan. Cloud-hosted is no longer offered at the Pro tier, so a previously cloud-hosted Pro account that resubscribes will need to choose the Team plan to stay on cloud-hosted, or continue on Pro as self-hosted.

​

Important notes

1. Active work is affected - All currently active issues will lose their context when switching
2. Local Cyrus must be running - For self-hosted runtime, your local Cyrus instance must be running for agents to function