Quick start

Install the CLI, start a self-hosted Workers control plane on your machine (no Docker required), and deploy a Worker version with a preview URL.

Routing is Host-based on the gateway (preview_url / prod_url from the API)—not path prefixes. See Preview & production before you open URLs in a browser.

Operator checklist: Step through deploy → Dashboard inspection → promote with Bearer admin token only (no login). Use the Operator journey checklist as your source of truth.

1. Install

curl -fsSL https://raw.githubusercontent.com/KonghaYao/cellp/main/scripts/install.sh | sh
export PATH="$HOME/.local/bin:$PATH"
cellp doctor

Details: Install. Component map: Architecture at a glance.

2. Run the platform

cellp dev --no-deploy

Leaves API on :8790 and gateway on :8787. Stop with Ctrl-C. Full notes: cellp dev.

3. Write a Worker (or use the example)

Minimal app:

my-shop/
  wrangler.jsonc
  index.js

See Write a Worker. From that directory:

cellp dev

Opens the version preview_url from the API (Host on :8787) after deploy is ready.

Ingress / hosts

User-facing rules: Preview & production · Gateway routing.

Contributor stack DNS (/etc/hosts, nip.io): dev/INGRESS-HOST.md — ./dev/scripts/ingress-host-init.sh local|magic.

Commerce example (from this repo)

git clone https://github.com/KonghaYao/cellp.git && cd cellp
# after install.sh so celld is on PATH
cd dev/examples/commerce
cellp dev --project commerce-store

Or the contributor stack with Docker RustFS: Local stack.

Docker (self-host)

docker compose up -d
curl -sf http://127.0.0.1:8790/v1/health

Image ghcr.io/konghayo/cellp. Self-hosting.

Next

• Architecture at a glance
• Operator journey (CLI → Dashboard → promote)
• cellp dev
• Write a Worker
• Configure bindings
• Deploy from CI