WAIIDE Port Summary
Calliope Integration: This component is integrated into the Calliope AI platform. Some features and configurations may differ from the upstream project.
🎯 Default Port Configuration
WAIIDE uses a dual-port architecture with one external-facing port and one internal port.
What You Need to Know
| Service | Default Port | Environment Variable | Access | Purpose |
|---|---|---|---|---|
| Main Service | 8070 | PORT or JUPYTERHUB_PORT | External | JupyterHub/API Server |
| WAIIDE Server | 8071 | VSCODE_PORT | Internal only | Core IDE (localhost) |
Quick Commands
# Docker run with defaults
docker run -p 8070:8070 calliopeai/waiide:latest
# Docker compose (uses default ports)
docker-compose up # Uses port 8070
# Override to common port 8080 if needed
docker run -p 8080:8080 -e PORT=8080 calliopeai/waiide:latest
# Health check
curl http://localhost:8070/api/status
# Access WAIIDE
open http://localhost:8070JupyterHub Configuration
port: 8070 # Default JUPYTERHUB_PORT
health_check:
endpoint: "/api/status"Internal Architecture
- Port 8070: All external traffic (JupyterHub SingleUser or API Server)
- Port 8071: WAIIDE Server (internal only, bound to 127.0.0.1)
- Routing: Main service proxies requests to WAIIDE
Port Override Examples
# Use port 8080 for main service
docker run -p 8080:8080 -e PORT=8080 calliopeai/waiide:latest
# Change WAIIDE internal port
docker run -p 8070:8070 -e VSCODE_PORT=8072 calliopeai/waiide:latest
# Both ports custom
docker run -p 9000:9000 -e PORT=9000 -e VSCODE_PORT=9001 calliopeai/waiide:latest📖 Note: The documentation previously incorrectly stated port 8080. The actual defaults are 8070/8071 as shown in the WAIIDE.