Deployment Toolkit

This directory contains the generic deployment assets for elizaOS apps: Dockerfiles, compose files, node rollout scripts, Cloudflare proxy sources, and the cloud-agent runtime helpers.

Layout

• deploy.defaults.env — shared defaults loaded by the setup and rollout scripts
• Dockerfile.ci — canonical image for prebuilt runtime/UI artifacts
• Dockerfile.cloud — cloud-optimized full-app image
• Dockerfile.cloud-agent — subordinate cloud-agent runtime image
• docker-compose.yml — gateway plus interactive CLI services
• docker-compose.supabase-db.yml — optional local Postgres service
• docker-setup.sh — local image build plus compose-based onboarding flow
• deploy-to-nodes.sh — image load / restart helper for remote Docker nodes
• cloudflare/eliza-cloud-proxy/ — proxy worker source and Wrangler example

App Overrides

Create a repo-root deploy/deploy.env and override only what differs from deploy.defaults.env. The scripts look for that file in this order:

1. DEPLOY_CONFIG
2. ./deploy.env
3. ../deploy/deploy.env

deploy-to-nodes.sh also looks for nodes.json in the same order, using DEPLOY_NODES_FILE, ./nodes.json, and ../deploy/nodes.json.

Common Commands

# Build a local image and walk through setup.
cd deploy
bash ../eliza/packages/app-core/deploy/docker-setup.sh

# Load the current image onto configured nodes.
cd deploy
bash ../eliza/packages/app-core/deploy/deploy-to-nodes.sh --status

Variables