Dockingstation Cloud

Host dockingstation (25+ AI coding agents) as cloud instances on Contree.

Turn the local dockingstation container into a scalable cloud platform where teams can spin up isolated instances of all 25+ AI tools instantly. No local installation needed.

What is This?

Dockingstation is a Docker container bundling 22+ AI coding agents (Claude Code, GitHub Copilot, Gemini, Aider, etc.). This project makes it cloud-native:

Local dockingstation container
    ↓
Push to Docker registry
    ↓
dockingstation-cloud API (Cloudflare Workers)
    ↓
Spin up cloud instances via Contree
    ↓
Access dockingstation in browser

Features

✅ Instant cloud instances — Create a dockingstation instance in <30s
✅ Isolated environments — Each user gets their own VM sandbox
✅ No setup — Access from browser, no local installation
✅ 25+ AI tools — All bundled in one container
✅ Team-ready — Share instances, manage permissions
✅ Cost-effective — Pay only for running instances

Architecture

┌─────────────────────────────────┐
│ User's Browser                  │
│ (http://dockingstation.cloud)   │
└────────────────┬────────────────┘
                 │
┌────────────────v─────────────────┐
│ Cloudflare Worker (Control Plane)│
│ • Instance CRUD                  │
│ • Auth + API keys                │
│ • Contree orchestration          │
└────────────────┬─────────────────┘
                 │
┌────────────────v─────────────────┐
│ Contree (Compute)                │
│ • Provisions MicroVMs            │
│ • Manages snapshots              │
└────────────────┬─────────────────┘
                 │
┌────────────────v─────────────────┐
│ Dockingstation Container         │
│ ├─ Claude Code                   │
│ ├─ GitHub Copilot                │
│ ├─ Gemini CLI                    │
│ ├─ Aider                         │
│ ├─ 18 more AI agents             │
│ ├─ VS Code Web                   │
│ └─ Linux Desktop (noVNC)         │
└─────────────────────────────────┘

Project Structure

dockingstation-cloud/
├── apps/
│   └── worker/              # Cloudflare Worker API
│       ├── src/
│       │   ├── index.ts     # Hono app + routes
│       │   ├── routes/
│       │   │   ├── instances.ts    # POST/GET/DELETE instances
│       │   │   └── health.ts       # Health check
│       │   ├── middleware/
│       │   │   └── auth.ts         # JWT/API key auth
│       │   ├── lib/
│       │   │   ├── contree-client.ts # Contree API calls
│       │   │   └── provisioner.ts    # Instance provisioning
│       │   └── globals.d.ts
│       └── wrangler.toml
├── packages/
│   ├── shared/
│   │   └── src/
│   │       ├── instance.ts   # Instance types
│   │       ├── api.ts        # API response wrappers
│   │       └── index.ts
│   ├── contree-client/
│   │   └── src/
│   │       ├── client.ts     # Contree API client
│   │       ├── types.ts
│   │       └── index.ts
│   └── cli/
│       └── src/
│           ├── commands/
│           │   ├── create.ts # Create instance
│           │   ├── list.ts   # List instances
│           │   └── delete.ts # Delete instance
│           ├── index.ts
│           └── cli.ts
├── Dockerfile.dockingstation  # Build dockingstation for Contree
├── package.json
├── pnpm-workspace.yaml
├── turbo.json
├── tsconfig.json
└── README.md

Quick Start

Prerequisites

Node.js 18+, pnpm
Contree account + API key
Docker (to build dockingstation image)

1. Clone

git clone https://github.com/opencolin/dockingstation-cloud.git
cd dockingstation-cloud
pnpm install

2. Build Dockingstation Image

# Build from source (or pull pre-built)
docker build -f Dockerfile.dockingstation -t dockingstation:cloud .

# Tag and push to registry
docker tag dockingstation:cloud docker.io/opencolin/dockingstation:cloud
docker push docker.io/opencolin/dockingstation:cloud

3. Configure Contree

cd apps/worker
echo "CONTREE_API_KEY=your_key_here" > .dev.vars
echo "CONTREE_BASE_URL=https://api.contree.co" >> .dev.vars

4. Start Dev Server

cd apps/worker
pnpm dev

Visit http://localhost:8787 (Worker API) and http://localhost:8787/api/health to test.

5. Create an Instance

curl -X POST http://localhost:8787/api/instances \
  -H 'Authorization: Bearer demo_token' \
  -H 'Content-Type: application/json' \
  -d '{}'

Response:

{
  "ok": true,
  "data": {
    "id": "instance_abc123",
    "status": "provisioning",
    "webUrl": "https://dockingstation.cloud/i/instance_abc123",
    "createdAt": "2026-04-19T10:30:45.123Z"
  }
}

Once status: "running", visit the web URL.

API Endpoints

Create Instance

POST /api/instances

curl -X POST http://localhost:8787/api/instances \
  -H 'Authorization: Bearer <token>'

List Instances

GET /api/instances

curl http://localhost:8787/api/instances \
  -H 'Authorization: Bearer <token>'

Get Instance

GET /api/instances/:id

curl http://localhost:8787/api/instances/instance_abc123 \
  -H 'Authorization: Bearer <token>'

Delete Instance

DELETE /api/instances/:id

curl -X DELETE http://localhost:8787/api/instances/instance_abc123 \
  -H 'Authorization: Bearer <token>'

CLI Tool

Manage instances from the terminal:

# Install globally (once built)
npm install -g @dockingstation-cloud/cli

# Create instance
dockingstation create

# List instances
dockingstation list

# Get instance details
dockingstation get instance_abc123

# Delete instance
dockingstation delete instance_abc123

# Open in browser
dockingstation open instance_abc123

Deployment

Development

cd apps/worker
pnpm dev

Production

# Build
pnpm turbo build

# Deploy to Cloudflare
cd apps/worker
wrangler deploy

Requires:

Cloudflare account + API token
Wrangler configured (wrangler login)
Contree API key set in Cloudflare secrets

Key Differences from opencode.cloud

Feature	opencode.cloud	dockingstation-cloud
Base image	opencode server	dockingstation container
Primary tool	opencode (1 agent)	22+ AI agents
Use case	AI-assisted coding	Multi-tool evaluation
Branching	Yes (explore approaches)	Optional (future)
Architecture	Sessions + CRDT collab	Instances + isolated envs

File Structure Walkthrough

`apps/worker/src/index.ts`

Hono app setup:

import { Hono } from 'hono';
import { healthRoute } from './routes/health';
import { instancesRoute } from './routes/instances';

type Env = {
  CONTREE_API_KEY: string;
  CONTREE_BASE_URL: string;
  KV: KVNamespace;
};

const app = new Hono<{ Bindings: Env }>();

app.get('/api/health', healthRoute);
app.route('/api/instances', instancesRoute);

export default app;

`packages/shared/src/instance.ts`

Type definitions:

export interface Instance {
  id: string;
  userId: string;
  status: 'provisioning' | 'running' | 'paused' | 'destroyed';
  contreeInstanceId: string;
  webUrl: string;
  createdAt: string;
  updatedAt: string;
}

`apps/worker/src/lib/provisioner.ts`

Contree orchestration:

export async function provisionInstance(
  contreeClient: ContreeClient,
  userId: string
): Promise<Instance> {
  // 1. Import dockingstation image
  // 2. Spin up MicroVM
  // 3. Start dockingstation server
  // 4. Return instance metadata
}

Roadmap

M0 (Now)

✅ Basic instance CRUD
✅ Contree integration
✅ API endpoints
⏳ CLI tool

M1 (Next)

Web dashboard (list, create, delete instances)
User authentication (OAuth)
API keys management
Instance sharing

M2 (Later)

Branching/snapshots (per instance)
Collaborative instances
Team management
Billing/usage tracking

Security

All requests require authentication:

# JWT token
-H 'Authorization: Bearer eyJ...'

# API key
-H 'Authorization: Bearer ds_live_...'

Sandboxes are isolated per user via Contree MicroVM isolation.

Cost

Component	Cost
Instance creation	$0.10
Per hour running	$0.50
Storage per GB/month	$0.01

Billed only while running.

Contributing

See CONTRIBUTING.md (coming soon).

License

MIT

Questions? Open an issue on GitHub.

Want to contribute? Fork + submit PR.

Found a bug? Report it with steps to reproduce.

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commit
apps/worker		apps/worker
packages		packages
.gitignore		.gitignore
Dockerfile.dockingstation		Dockerfile.dockingstation
README.md		README.md
package.json		package.json
pnpm-workspace.yaml		pnpm-workspace.yaml
tsconfig.json		tsconfig.json
turbo.json		turbo.json

Folders and files

Latest commit

History

Repository files navigation