This guide uses Docker to run Coze Studio, ByteDance’s open-source AI agent development platform.
For Docker installation, see Docker.
Clone the Coze Studio repository and change into the project directory.
git clone https://github.com/coze-dev/coze-studio.git && cd coze-studio
The make web command handles environment configuration automatically:
make web
Copy the example environment file:
cp ./docker/.env.example ./docker/.env
Edit ./docker/.env to customize your configuration if needed.
make web
docker compose -f ./docker/docker-compose.yml up
To run Coze Studio as a background service:
docker compose -f ./docker/docker-compose.yml up -d
Open your browser and navigate to:
| Action | Command |
|---|---|
| Start service | docker compose -f ./docker/docker-compose.yml up |
| Start in background | docker compose -f ./docker/docker-compose.yml up -d |
| Stop service | docker compose -f ./docker/docker-compose.yml down |
| View logs | docker compose -f ./docker/docker-compose.yml logs -f |
| Rebuild images | docker compose -f ./docker/docker-compose.yml up --build |
| Restart service | docker compose -f ./docker/docker-compose.yml restart |
To run Coze Studio on a custom port, edit the Docker Compose file:
services:
# ... other services ...
ports:
- "YOUR_PORT:8888" # Change 8888 to your desired port
Then restart the stack:
docker compose -f ./docker/docker-compose.yml up -d
To upgrade to the latest version:
# Pull latest images
cd coze-studio
git pull
# Rebuild and restart
docker compose -f ./docker/docker-compose.yml up -d --build --pull always
After installation, complete these steps:
Any questions?
Feel free to contact us. Find all contact information on our contact page.