Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/denoland/celld/llms.txt

Use this file to discover all available pages before exploring further.

Celld is an open-source daemon that lets you run Cloudflare Workers and Durable Objects on your own infrastructure. Each object — called a cell — is a named, stateful unit with its own private SQLite database, continuously replicated to an object-storage bucket you own. Nodes coordinate through that bucket alone, with no control plane and no consensus service.

Quickstart

Deploy the counter example and run your first node in minutes.

Installation

Install the celld binary or pull the container image.

Worker API

Explore the supported Cloudflare Workers and Durable Objects surface.

Operations

Configure nodes, tune memory limits, and operate a production fleet.

​
How celld works

Every celld node embeds V8 and executes Wrangler bundles. The fleet shares one bucket — S3-compatible or Google Cloud Storage — which holds deployments, cell state, and ownership records. Object-storage compare-and-swap ensures exactly one node owns a cell at a time, without a membership protocol or consensus service. Celld continuously replicates each cell’s SQLite database to the bucket. When a cell moves or an inactive cell activates, its new owner restores that database and resumes execution. The bucket is the durable source of truth; nodes are replaceable.

Object Storage

Set up S3-compatible or GCS buckets for your fleet.

Deploy an App

Deploy Wrangler projects with celld deploy.

Run a Fleet

Add nodes and operate a distributed fleet.

​
What you can build with cells

A cell is the right primitive for any workload that divides into named, stateful units:
  • Real-time applications — a multiplayer game, chat room, or collaborative document is one cell. The cell holds the WebSocket connections and room state, so no external message bus is needed.
  • AI agents — each agent is one cell with its own memory, schedule, and inbox. Idle agents hibernate to the bucket, so a large fleet costs almost nothing between events.
  • Sharded web applications — one cell per user, tenant, or device shards the application from the start. No shared database means no shared contention.
Celld is currently in alpha. Review the limitations and security pages before operating a public fleet.

Build docs developers (and LLMs) love

Get started for freeTalk to us