Skip to content
🥋 Dojo

Deployment

Dojo runs on Cloudflare Workers with Durable Objects for state management. You can deploy your own instance.

Architecture

Section titled “Architecture”

Dojo’s server consists of:

  • Cloudflare Worker — handles API requests and serves the web UI
  • Durable Objects — manage repository state with strong consistency
  • R2 Storage — stores large objects (blobs, trees)

Prerequisites

Section titled “Prerequisites”
  • A Cloudflare account with Workers Paid plan (for Durable Objects)
  • Node.js 18+ and wrangler CLI
  • The Dojo source code

Deploying

Section titled “Deploying”
Terminal window
# Clone the repository
git clone https://github.com/nichochar/dojo
cd dojo


# Install dependencies
bun install


# Deploy the worker
cd packages/worker
bun run deploy

Configuration

Section titled “Configuration”

Configure your deployment through wrangler.jsonc in packages/worker/:

  • Custom domain — set up a custom domain in the Cloudflare dashboard
  • Environment variables — configure secrets with wrangler secret put
  • D1 database — create and bind a D1 database for metadata storage

DNS setup

Section titled “DNS setup”

Point your domain to the Cloudflare Worker:

  1. Add your domain to Cloudflare
  2. In Workers & Pages → your worker → Custom Domains
  3. Add your domain (e.g., dojo.yourdomain.com)