Get started

This path installs the current formal release, starts one local instance, and deploys a minimal Worker. Formal binaries are available for macOS on Apple silicon and Linux on ARM64 or x86-64.

Set up with an AI coding agent

Copy this prompt into Codex, Claude Code, or another coding agent. The code block has a one-click copy button:

Read https://open-compute.dev/llms.txt and install the current open-compute release on this machine. Configure one local instance, inspect any existing installation first, preserve its configuration and instance data, ask before using sudo or making destructive changes, then run ocd status and report the result.

llms.txt contains the minimum setup and usage instructions, with links to detailed documentation when needed.

1. Install

Install the latest formal release:

curl -fsSL https://open-compute.dev/install.sh | sudo sh

The installer selects the matching platform binary, verifies the release checksums, and installs ocd into /usr/local/bin.

2. Set up the platform

Create the recommended system configuration, register the managed service, and start the first instance:

sudo ocd setup --yes

Verify the instance and open the Dashboard:

ocd status
ocd dashboard

status must report ready. dashboard opens a one-time login URL; it does not ask you to copy a long-lived admin token.

3. Create a Worker project

Create an ordinary Wrangler project and keep Wrangler project-local:

mkdir hello-worker
cd hello-worker

npm

npm init -y
npm install --save-dev wrangler@4.127.1 @open-compute/workers-types

pnpm

pnpm init
pnpm add --save-dev wrangler@4.127.1 @open-compute/workers-types

bun

bun init -y
bun add --dev wrangler@4.127.1 @open-compute/workers-types

mkdir src

Create src/index.ts:

export default {
  fetch(request: Request): Response {
    return Response.json({
      message: "hello from open-compute",
      path: new URL(request.url).pathname,
    });
  },
} satisfies ExportedHandler;

Create wrangler.jsonc:

{
  "$schema": "node_modules/wrangler/config-schema.json",
  "name": "hello-worker",
  "main": "src/index.ts",
  "compatibility_date": "2026-09-08",
  "workers_dev": false
}

4. Develop and deploy

Use Wrangler directly for the fast local loop:

npm

npm exec -- wrangler dev

pnpm

pnpm exec wrangler dev

bun

bun run wrangler dev

Then deploy through the selected open-compute instance:

ocd wrangler deploy

Use the platform path printed by Wrangler to call the Worker. To inspect live logs:

ocd wrangler tail

Next, read Develop for environments and remote targets, Operate for production configuration, or Products for bindings.