Skip to main content

Self-hosting

View as Markdown

Run the RocketRide engine on your own machine when you want full control over where data and model calls go. It is the same engine that powers Cloud; only the operator changes.

Fastest path: the VS Code extension manages a local runtime for you while you build, with no manual setup. Use the steps below when you want to run the engine as a standalone service. Setting it up from a coding agent? The coding-agents start page has the copy-paste Docker commands to run the engine, check it and connect over MCP.

Get the engine​

Download a release build, no build toolchain required.

  1. Open the releases page and choose the latest RocketRide Server release (tags look like server-v3.2.2; ignore the client and extension releases).

  2. Download the archive for your platform:

    PlatformAsset
    Linux (x64)rocketride-server-<version>-linux-x64.tar.gz
    macOS (Apple Silicon)rocketride-server-<version>-darwin-arm64.tar.gz
    Windows (x64)rocketride-server-<version>-win64.zip
  3. Extract it. The folder is your runtime directory: it contains the engine binary and its ai/ runtime.

The archive carries the engine and the nodes it needs itself. The other nodes are in rocketride-nodes-<version>.zip on the same release. Download it too and put it in a nodes/ folder beside the runtime directory (rocketride-engine/../nodes/): a run gets the nodes its pipeline names from there, so no node code is downloaded at run time. A node's Python packages and models still install on first use; provision them in advance for an offline host.

mkdir rocketride-engine && tar -xzf rocketride-server-<version>-linux-x64.tar.gz -C rocketride-engine
cd rocketride-engine

Building from source instead? That path is for contributors and is documented in the repository's development guide (docs/development/index.md), which also covers the Docker Compose stack that bundles the engine with its data stores. The steps below apply to the runtime directory either way.

Set up and start listening​

The extracted archive is your runtime directory.

On Linux, install the runtime dependencies (libc++1, libc++abi1, libgomp1) before starting:

# Debian / Ubuntu
sudo apt install libc++1 libc++abi1 libgomp1
# Fedora / RHEL
sudo dnf install libcxx libcxxabi libgomp
# Alpine
sudo apk add libc++ libgomp

From inside the runtime directory, start the engine. This binds to 127.0.0.1 (localhost only) by default:

# Linux / macOS
./engine ./ai/eaas.py --host=127.0.0.1

# Windows
engine.exe ./ai/eaas.py --host=127.0.0.1

The engine now listens for the WebSocket protocol on port 5565. Only pass --host=0.0.0.0 (all interfaces) once the engine sits behind TLS and authentication — see Connect a client below.

Verify it is running​

The engine serves a public version endpoint on port 5565:

curl http://localhost:5565/version

Connect a client​

Point any SDK or the CLI at the engine. The client must send a key. Use the key the engine was started with; an engine started without ROCKETRIDE_APIKEY accepts any non-empty value:

ROCKETRIDE_URI=ws://localhost:5565
ROCKETRIDE_APIKEY=rr_local
import { RocketRideClient } from 'rocketride';

const client = new RocketRideClient({ uri: 'ws://localhost:5565', auth: 'rr_local' });
await client.connect();

Expose the engine beyond localhost and you should put it behind TLS and authentication (set ROCKETRIDE_APIKEY). For a clustered deployment, see the Helm chart under deploy/helm/rocketride/.

Provider credentials​

Pipelines that call external models or stores need those providers' API keys. Supply them as environment variables in the engine's environment (never committed); a node's config references the variable rather than the literal secret. See Nodes for each provider's required keys.