Instances

Instances (Environments) are isolated Odoo deployments running in Docker containers. Each instance has its own database, filestore, and configuration.

Instance States

State	Description	Actions
RUNNING	Active and accessible	Stop, Restart, Deploy, Quick Update
STOPPED	Inactive, data preserved	Start, Delete
DEPLOYING	Deployment in progress	View Logs
ERROR	Deployment failed	View Logs, Retry

Available Actions

Deploy: Full deployment with git clone, container build, and DB init
Quick Update: Fast update without full rebuild (30-60s)
Clone: Copy instance to new environment
Start/Stop: Control instance state
Restart: Restart Odoo container
Rollback: Revert to previous deployment
Delete: Remove instance and free resources

Configuration

Technical Name: Unique identifier used for containers and DB
Display Name: Human-readable name shown in UI
Branch: Git branch to deploy
Auto Deploy: Enable automatic deploy on git push
Environment Variables: Custom configuration per instance

API Endpoints

POST   /environments/:id/deploy              # Full deploy
POST   /environments/:id/quick-update        # Fast update
POST   /environments/:id/clone               # Clone environment
POST   /environments/:id/start             # Start instance
POST   /environments/:id/stop              # Stop instance
POST   /environments/:id/restart           # Restart instance
POST   /environments/:id/rollback            # Rollback deploy
DELETE /environments/:id                   # Delete instance

Access URLs

Once deployed, instances are accessible via:

Custom Domain: Configured in domain settings
SPCBot Subdomain: instance-name.spcbot.com
Direct IP: http://server-ip:allocated-port