Cloud Codes Gateway

Deploy your own Cloud Codes backend gateway — no secrets required.

What is this?

This is the backend gateway for Cloud Codes. It runs the FastAPI server that powers agent runs, sandbox management, and credential storage.

Deploy this to your own infrastructure and connect it to the hosted frontend — authentication and JWT signing are handled automatically.

Deploy

One-click deploy

Prerequisites

Install Docker Desktop for your platform:

• macOS: Download Docker Desktop for Mac
• Windows: Download Docker Desktop for Windows
• Linux: Install Docker Engine

Make sure Docker is running before proceeding. If you see an error like failed to connect to the docker API, start Docker Desktop first.

Build and run

docker build -t cloud-codes-gateway .
docker run -p 8081:8081 cloud-codes-gateway

After deploying

1. Copy your backend URL (e.g. https://cloud-codes-gateway.onrender.com)
2. Open Cloud Codes
3. Go to the Vault panel and click Connect Existing
4. Paste your backend URL and connect

Optional configuration

These are not required but unlock additional features. Set them as environment variables on your hosting platform.

Variable	Description
DATABASE_URL	PostgreSQL connection string — enables Vault credential storage
ENCRYPTION_MASTER_KEY	Encryption key for vault (required if using DATABASE_URL)
FLY_API_TOKEN	Fly.io API token for managed gateway provisioning
CORS_ORIGIN	Override the allowed frontend origin (default: https://cloud.openknot.ai)

Local development

cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Optional: copy .env.example to .env and configure
cp .env.example .env

python server.py

The API will be available at http://localhost:8081/docs.