Skip to main content
Cyrus offers two runtime modes that determine where your Cyrus instance runs. Admin users can switch between these runtimes at any time.

​
Runtime Types

​
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

​
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

​
How to Switch Runtimes

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. Runtime badge showing "self-hosted" in the header

​
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. Dialog explaining the runtime switch to cloud-hosted 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. Confirmation dialog with warning about losing active issue context
Switching runtimes is a significant action. The context of all currently active issues will be lost, and agents will need to rebuild their understanding of ongoing work. This action cannot be undone without losing progress on active issues.
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
  • Pro and Team plans have access to runtime switching
  • Enterprise plans have fixed runtime configurations managed by your organization

​
Important Notes

Plan pricing stays the same - Switching runtimes does not affect your subscription or billing.
  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