Bindings
Binding configuration
Which Wrangler bindings run on OpenOrange as is, which need a service that you supply, and which are not supported.
OpenOrange reads your bindings from the same wrangler.jsonc as wrangler dev.
Each binding runs as is, needs a service that you set, or is not supported, in
which case it loads and its calls throw.
Quickstart
You need the orange CLI.
-
Add the bindings
Use the same keys as on Cloudflare.
{ "name": "my-worker", "main": "src/index.ts", "compatibility_date": "2026-09-03", "kv_namespaces": [{ "binding": "CACHE", "id": "cache" }], "ai": { "binding": "AI" }, "images": { "binding": "IMAGES" } } -
Check them
orange doctorlists each binding, what it runs on, and what it needs from you.orange doctor Binding Resource On Rivet Runs on ! env.IMAGES Images not supported stub · calls throw Orange has no backend for this binding. Call the service's HTTP API with fetch(), or keep this code off Orange. https://github.com/rivet-dev/open-orange/blob/main/docs/modules/bindings.mdx env.AI Workers AI needs a service OpenAI-compatible API Set OPENROUTER_API_KEY, or ORANGE_AI_BASE_URL for another provider. https://github.com/rivet-dev/open-orange/blob/main/docs/modules/workers-ai.mdx env.CACHE KV Namespace runs as is Rivet Actor https://github.com/rivet-dev/open-orange/blob/main/docs/modules/kv.mdx 1 of 3 bindings run as is, 1 needs a service, 1 is not supported -
Set up each service
Put the variable that
orange doctornames in.dev.vars, next towrangler.jsonc, and check again.echo 'OPENROUTER_API_KEY=<your key>' >> .dev.vars orange doctor ✓ Workers AI env.AI · OpenRouter ● Ready for orange dev -
Start the Worker
When it starts,
orange devlists each binding and what it runs on.orange dev
Replace a binding that is not supported
The Worker still starts, and only the calls to that binding throw. Move those
calls to a service that the Worker reaches with fetch(). The reference below
names one for Vectorize, Images, and
Analytics Engine.
Set the variables on a deploy
orange deploy keeps .dev.vars out of the image. Pass it as secrets
instead. See Variables and secrets.
orange deploy --secrets-file .dev.vars
AI context Compatibility, limits and details
Written for LLMs and coding agents: every edge case, measurement, and known deviation. You do not need it to use the feature.
Compatibility
| Binding | Wrangler key | Kind | Runs on | Notes |
|---|---|---|---|---|
| Variables | vars | Runs as is | The Worker process | Strings and JSON values. |
| Local secrets | .dev.vars, .env | Runs as is | The Worker process | Loaded like wrangler dev. See Variables and secrets. |
| Secrets Store | secrets_store_secrets | Runs as is | The Worker process | Local values come from .dev.vars or the process environment. See Secrets Store. |
| Version metadata | version_metadata | Runs as is | The Worker process | See Version metadata. |
unsafe_eval | unsafe.bindings | Runs as is | The Worker process | |
| Static assets | assets | Runs as is | Local files | See Static assets. |
| Durable Objects | durable_objects | Runs as is | One Rivet Actor for each object | Partial. Same-Worker classes from new_sqlite_classes and new_classes migrations. See Durable Objects. |
| Durable Objects from another Worker | durable_objects with script_name | Runs as is | The other Worker’s Rivet Actors | Both Workers run in one orange dev. See Multiple Workers. |
| Service bindings to this Worker | services | Runs as is | The Worker process | fetch(), JS RPC, named entrypoints, props, and ctx.exports. |
| Service bindings to another Worker | services | Runs as is | The other Worker’s process | Partial. Run both Workers in one orange dev with repeated -c. WebSocket upgrades throw. See Multiple Workers. |
| Dispatch namespaces | dispatch_namespaces | Runs as is | The Workers of the orange dev session | Partial. See Multiple Workers. |
| KV | kv_namespaces | Runs as is | One Rivet Actor for each namespace | See KV. |
| D1 | d1_databases | Runs as is | One Rivet Actor for each database | See D1. |
| Rate Limiting | ratelimits, unsafe.bindings | Runs as is | One Rivet Actor for each namespace | See Rate Limiting. |
| R2 | r2_buckets | Runs as is | One Rivet Actor for each bucket, or your S3-compatible store | Set ORANGE_R2_<BUCKET>_S3_* to use Amazon S3, Cloudflare R2, Google Cloud Storage, or Backblaze B2. See R2. |
| Queues | queues.producers, queues.consumers | Runs as is | One Rivet Actor for each queue | See Queues. |
| Workflows | workflows | Runs as is | Cloudflare’s own Workflows engine, with one Rivet Actor for each instance | Partial. See Workflows. |
| Tail Workers | tail_consumers | Runs as is | Rivet Durable Streams | Partial. See Tail Workers. |
| Worker Loader | worker_loaders | Runs as is | One Node.js process for each dynamic Worker, in an agentOS VM | Partial. See Worker Loader. |
| Workers AI | ai | Needs a service | An OpenAI-compatible provider | Set OPENROUTER_API_KEY, or ORANGE_AI_BASE_URL for OpenAI, Groq, Together AI, or Fireworks AI. See Workers AI. |
| Send Email | send_email | Needs a service | Your SMTP server | Set ORANGE_EMAIL_SMTP_URL to Amazon SES, Resend, Postmark, SendGrid, or Mailgun. Without it, the binding throws. See Email. |
| Browser Rendering | browser | Needs a service | A hosted browser or your Chrome, through its DevTools Protocol endpoint | Set ORANGE_BROWSER_CDP_URL to Browserbase, Browserless, or Steel. Without it, the binding throws. See Browser Rendering. |
| Hyperdrive | hyperdrive | Needs a service | Your database, with a direct connection | Set the local connection string, as for wrangler dev, such as PlanetScale, Amazon RDS, Neon, or Supabase. No pooling or query cache. See Hyperdrive. |
| Analytics Engine | analytics_engine_datasets | Not supported | Nothing | See Analytics Engine. |
| Vectorize | vectorize | Not supported | Nothing | See Vectorize. |
| Images, Media, Stream | images, media, stream | Not supported | Nothing | See Images. |
| Pipelines | pipelines | Not supported | Nothing | See Pipelines. |
| AI Search | ai_search, ai_search_namespaces | Not supported | Nothing | See AI Search. |
| mTLS certificates | mtls_certificates | Not supported | Nothing | See mTLS certificates. |
| VPC | vpc_networks, vpc_services | Not supported | Nothing | See VPC. |
| Legacy blobs | text_blobs, data_blobs, wasm_modules | Not supported | Nothing | See Legacy blobs. |
| Other binding types | Not supported | Nothing | Includes other unsafe binding types. |
Kinds
- Runs as is: OpenOrange implements the Cloudflare API. You set nothing.
- Needs a service: OpenOrange implements the Cloudflare API on a service that you supply, such as your SMTP server. You set one variable that points to it.
- Not supported: Orange has no backend for the binding. The Worker loads,
and
env.NAMEexists. Each method call throws an error that names the binding and suggests an alternative. Analytics Engine is the exception: it accepts writes and drops them.
orange doctor reports each binding of your project as one of these kinds. It
does not list variables (vars, .dev.vars, and .env), because they need
nothing on Rivet. A binding that is not supported does not fail
orange doctor, also with --strict.
Where the data goes
- Under
orange dev, Rivet Actors run on a local Rivet Engine, and the data stays on your machine. - Under
orange deploy, they run on your Rivet cluster. - A binding that needs a service sends its data to the service that you set.
Configuration that stops orange dev
Configuration that changes how the Worker runs, not what env contains, stops
orange dev with Unsupported Wrangler configuration: <keys>. The keys are
cloudchamber, connect, define, exports, legacy_assets,
pages_build_output_dir, site, streaming_tail_consumers,
triggers.events, and any unsafe setting other than unsafe.bindings.
These load instead:
orange devacceptscontainerswith a warning, and runs@cloudflare/sandboxclasses on a sandbox provider, such as E2B, Daytona, or Freestyle. See Sandbox.orange devrunstriggers.crons(see Cron Triggers), and deliversqueues.consumersto the Worker’squeue()handler (see Queues).
Stubs
orange dev marks each binding that is not supported in its binding table at
startup, with what to use instead on the next line:
Binding Resource Runs on
! env.IMAGES Images stub · calls throw
See the OpenOrange bindings documentation for supported bindings.The binding is a stub, and it is safe to pass around. typeof env.IMAGES is
"object", reading a property returns a function, and awaiting the stub does
not call it. Calling any method throws an Error with the same message:
await env.IMAGES.info(stream);
// Error: Images binding "IMAGES" is not supported by OpenOrange. See the OpenOrange bindings documentation for supported bindings.The message’s second sentence is the alternative for that binding type, such
as a vector database for Vectorize, or an import for a Wasm module.
orange doctor prints its own hint for each stub, with a link to this page.
Variables and secrets
orange dev resolves variables with Wrangler’s own wrangler dev logic:
- It starts with
varsfrom the Wrangler configuration. - It loads
.dev.vars.<env>or.dev.varsnext to the configuration file. - If neither file exists, it loads
.env,.env.local,.env.<env>, and.env.<env>.local. SetCLOUDFLARE_INCLUDE_PROCESS_ENV=trueto also load the process environment. - Loaded values become string bindings that replace
varswith the same name. - If
secrets.requiredis set, only the listed keys load, andorange devwarns about missing keys withMissing required secrets: <keys>. Add them to .dev.vars, .env, or set as environment variables.
- A
.dev.varsentry named after another binding, such as a Secrets Store binding, stays that binding’s local value and does not replace it. - Secret values never become part of the version metadata ID.
Bindings without a page
Orange has no backend for these bindings. Each card’s status, migration path, and checks come from the conformance data.
Vectorize
Runs on Stub binding
- Works
- The configuration loads, and
env.NAMEis a stub that the Worker can pass around - Missing
- Every method. Each call throws, and the error names a vector database to use instead.
- Migration
- Not supported
orange migratedoes not move Vectorize indexes. Copy the data yourself.
- Configure
vectorize- Checks
- 1 fail
The error’s alternative reads: Call a vector database, such as Qdrant Cloud or Pinecone, with fetch(), or use pgvector through Hyperdrive. For a few thousand vectors, store the embeddings in SQLite and rank them by cosine similarity in JavaScript.
| Use instead | How the Worker reaches it |
|---|---|
| pgvector on Neon or Supabase | A Hyperdrive binding and a Postgres driver |
| Qdrant Cloud | fetch() to https://<cluster host>:6333, with the api-key header |
| Pinecone | fetch() to the index host, with the Api-Key header |
| SQLite in a Durable Object, for a few thousand vectors | Store the embeddings, and rank them by cosine similarity in JavaScript |
Images
Runs on Stub bindings
- Works
- The
images,media, andstreamconfiguration loads, and each binding is a stub - Missing
- Every method of Images, Media Transformations, and Stream. Each call throws.
- Migration
- Not supported The bindings are stubs. Images and videos stored on Cloudflare stay there.
- Configure
imagesmediastream- Checks
- 1 fail
| Use instead | How the Worker reaches it |
|---|---|
| Cloudinary | fetch() to its upload and transformation URLs |
| imgproxy that you run | fetch() to its processing URLs |
Pipelines
Runs on Stub binding
- Works
- The configuration loads, and the binding is a stub
- Missing
send()and every other method. Each call throws.- Migration
- Not supported
orange migratedoes not move Pipelines. Copy the data yourself.
- Configure
pipelines- Checks
- 1 fail
AI Search
Runs on Stub binding
- Works
- The
ai_searchandai_search_namespacesconfiguration loads, and each binding is a stub - Missing
- Every method, and
env.AI.autorag()andenv.AI.aiSearch()on the Workers AI binding. Each call throws. - Migration
- Not supported
orange migratedoes not move AI Search instances. Copy the data yourself.
- Configure
ai_searchai_search_namespaces
Analytics Engine
Runs on A dataset that drops every data point, as Miniflare does
- Works
writeDataPoint()accepts data points, aswrangler devdoes- Differs
- Orange stores nothing. It drops every data point, and
orange doctorshows the binding asdrops writes. - Missing
- The SQL API that queries a dataset
- Migration
- Not supported
orange migratedoes not move Analytics Engine datasets. Copy the data yourself.
- Configure
analytics_engine_datasets
To keep the data, send each data point to your own analytics store with
fetch() to its ingest API.
mTLS certificates
Runs on Stub binding
- Works
- The configuration loads, and the binding is a stub
- Missing
fetch()with the certificate. Each call throws.- Migration
- Not supported The binding is a stub. Certificates uploaded to Cloudflare stay there.
- Configure
mtls_certificates- Checks
- 1 fail
VPC
Runs on Stub bindings
- Works
- The
vpc_networksandvpc_servicesconfiguration loads, and each binding is a stub - Missing
- Every call through a VPC network or service. Each call throws.
- Migration
- Not needed A VPC binding holds no data.
- Configure
vpc_networksvpc_services
Use fetch() to reach the host network directly.
Legacy blobs
Runs on Stub bindings
- Works
- The
text_blobs,data_blobs, andwasm_modulesconfiguration loads, and each binding is a stub - Missing
- The file contents.
env.NAMEis a stub, and each call on it throws. - Migration
- Not needed Blobs are files in the project.
- Configure
text_blobsdata_blobswasm_modules
Import the file from the Worker source instead. For a Wasm module, the error
reads Import the WebAssembly module from the Worker source instead.
Conformance
Recorded results from the conformance run of 2026-11-10 (Orange ea40348), 1,670 of 1,851 tests passing across every area. Each check is works when every result passed and partial when some did. The full feature matrix is on the compatibility page.
Vectorize
| Check | Status | Results |
|---|---|---|
| Vectorize, Images, Pipelines, mTLS | Does not work |
|
Images, Media, Stream
| Check | Status | Results |
|---|---|---|
| Vectorize, Images, Pipelines, mTLS | Does not work |
|
Pipelines
| Check | Status | Results |
|---|---|---|
| Vectorize, Images, Pipelines, mTLS | Does not work |
|
AI Search
| Check | Status | Results |
|---|
Analytics Engine
| Check | Status | Results |
|---|
mTLS certificates
| Check | Status | Results |
|---|---|---|
| Vectorize, Images, Pipelines, mTLS | Does not work |
|
VPC
| Check | Status | Results |
|---|
Legacy blobs
| Check | Status | Results |
|---|