Skip to content
Getting started / Introduction

Getting started

Documentation

Run your Cloudflare Workers and Durable Objects on Rivet with no changes to your app code.

OpenOrange reads your Wrangler configuration and runs the same Worker on Node.js. Each Durable Object runs as a Rivet Actor with its own SQLite database.

Quickstart

You need a Worker project with a wrangler.jsonc, wrangler.json, or wrangler.toml, Node.js 22 or later, and pnpm. Deploying also needs Docker.

Step 1: Install

Install the orange CLI globally, then run it in your Worker project. Your code and your Wrangler configuration do not change.

pnpm add -g open-orange

Step 2: Run your Worker

Your Worker answers on http://localhost:8787. Each Durable Object runs as a Rivet Actor with its own SQLite database, kept in .open-orange/.

orange dev

Step 3: Deploy

orange deploy builds an image of your Worker and rolls it out to a Rivet cluster, then prints its public URL. See the deploy guide.

orange login
orange link --cluster <cluster-name>
orange deploy

Your app has data on Cloudflare? Follow the migration guide.

Explore the docs