Cloud Mode Overview

rayobrowse cloud is a managed browser service at cloud.rayobrowse.com. Instead of running Docker yourself, you connect with an API key — no SDK required.

How it works

1. Point any CDP client at the /connect endpoint with your API key:

   wss://cloud.rayobrowse.com/connect?token=YOUR_API_KEY&os=windows

2. The cloud creates a browser and returns a direct CDP WebSocket URL

3. You automate with Playwright, Puppeteer, Selenium, or any CDP client

4. When you disconnect, the browser is cleaned up automatically

The cloud gateway is not in the data path — after the initial /connect request, your CDP traffic goes directly to the browser instance.

Tip

The /connect endpoint works exactly the same as local mode — same URL pattern, same parameters. The only difference is wss://cloud.rayobrowse.com instead of ws://localhost:9222 and a token parameter for authentication.

When to use cloud vs local

	Local Mode	Cloud Mode
Setup	Docker on your machine	API key only
Connection	ws://localhost:9222/connect?...	wss://cloud.rayobrowse.com/connect?token=KEY&...
Scaling	Limited by your hardware	Scales automatically
Cost	Free (1 browser) or paid threads	Usage-based
Maintenance	You manage Docker updates	Managed for you
Best for	Development, small-scale, full control	Production, scaling, no infra management

Getting started

1. Get an API key — contact support@rayobyte.com or fill out the access form
2. Follow the cloud quickstart — working code in under 2 minutes