Install Celld: Binary and Container Options

celld ships as a pre-built binary for Linux x86-64, Linux ARM64, and macOS ARM64. It is also published as a multi-arch container image for Linux x86-64 and ARM64. Choose the installation method that fits your environment.

Install

Binary Installer
Container

Run the one-line installer to download and install the celld binary:

curl -fsSL https://celld.dev/install.sh | sh

The installer places the binary under ~/.local/lib/celld/releases and creates a symlink at ~/.local/bin/celld. If the installer tells you to, add ~/.local/bin to your PATH:

export PATH="$HOME/.local/bin:$PATH"

Add that line to your shell’s startup file (e.g. ~/.bashrc or ~/.zshrc) to make it permanent.Pin a specific versionSet CELLD_VERSION to the tag of the release you want before running the installer. You can find all available tags on the GitHub releases page.

CELLD_VERSION=v0.0.1 curl -fsSL https://celld.dev/install.sh | sh

To roll back to an earlier release, run the installer again with the tag of that release.Verify provenanceEvery release has a GitHub Actions build attestation. Verify that a downloaded asset was built by the official workflow:

gh attestation verify <asset> --repo denoland/celld

The release image is published to the GitHub Container Registry for Linux x86-64 and ARM64. Confirm the image is accessible:

docker run --rm ghcr.io/denoland/celld --version

Run a node with persistent stateCreate a named volume to persist the local SQLite work directory across container restarts, then start the node:

docker volume create celld-state

docker run --rm --network host \
  -e AWS_ACCESS_KEY_ID \
  -e AWS_SECRET_ACCESS_KEY \
  -e AWS_SESSION_TOKEN \
  -e CELLD_WATCH=/var/lib/celld/state \
  -v celld-state:/var/lib/celld \
  ghcr.io/denoland/celld \
  --bucket s3://my-cells-bucket \
  --endpoint https://ACCOUNT.r2.cloudflarestorage.com \
  --region auto \
  --listen 0.0.0.0:8080 \
  --internal-listen 10.0.0.12:8081 \
  --advertise node-a.internal:8081

Drop --endpoint and --region when using Amazon S3.
Expose port 8080 through your load balancer for public traffic.
Keep port 8081 on a private network — it serves peer HTTP and the unauthenticated operator API and must not be exposed to the public internet.

Pass additional AWS or Google credentials as environment variables using the same -e pattern shown above.

Prerequisites

esbuild is required when deploying projects that contain Worker code (celld deploy). Asset-only projects do not need it. Install esbuild before running celld deploy:

# npm (global)
npm install -g esbuild

# Homebrew (macOS / Linux)
brew install esbuild

Set CELLD_ESBUILD to the full path of the executable if it is not on your PATH:

export CELLD_ESBUILD=/usr/local/bin/esbuild

Supported platforms

Platform	Binary	Container
Linux x86-64	✅	✅
Linux ARM64	✅	✅
macOS ARM64 (Apple Silicon)	✅	—
macOS x86-64 (Intel)	❌ No prebuilt binary	—
Windows	❌	—

Windows is not supported. celld does not run on Windows and no Windows binary is provided. Use Linux or macOS ARM64.

Intel Mac users must build from source. The source is available in the denoland/celld repository.

Uninstall

The installer keeps each release under ~/.local/lib/celld/releases and points a symlink at the current one. To remove celld completely, delete the symlink and the releases directory:

rm `which celld` && rm -rf ~/.local/lib/celld

Get Started

Object Storage

Deploying & Running

Worker API

Operations

Install Celld: Binary and Container Options

Install

Prerequisites

Supported platforms

Uninstall

Build docs developers (and LLMs) love

Get Started

Object Storage

Deploying & Running

Worker API

Operations

Documentation Index

​Install

​Prerequisites

​Supported platforms

​Uninstall

Build docs developers (and LLMs) love

Install

Prerequisites

Supported platforms

Uninstall