Skip to content

Installation

cloudscode ships as a small set of services: an API control plane, a dashboard, and one or more runtime workers. You can run all of it on a single Hetzner box (or your laptop) with Docker Compose.

Prerequisites

Linux host with Docker 24+ and Docker Compose v2.
A domain you control (for production); localhost is fine for development.
(Optional) Cloudflare account for the recommended edge stack.

Quick start (self-hosted)

git clone https://github.com/cloudscode/cloudscode
cd cloudscode/deploy
cp .env.example .env
# edit .env — set DOMAIN, ADMIN_EMAIL, and any BYOK provider defaults
docker compose up -d

Verify the control plane is up:

curl -sS http://localhost:8787/healthz
# => {"ok":true,"env":"production"}

Local development

Clone the monorepo and start each app individually:

git clone https://github.com/cloudscode/cloudscode
cd cloudscode
bun install
bun run --filter './apps/api' dev      # API on :8787
bun run --filter './apps/dash' dev     # Dashboard on :5173
bun run --filter './apps/docs' dev     # These docs on :4321

Next