Configuration
Service Settings
Service Settings
Each service in DevDock has several configurable options.
Configuration Fields
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| name | string | Yes | Display name of the service |
| command | string | Yes | Shell command to execute |
| cwd | string | Yes | Working directory (absolute path) |
| port | number | No | Port the service listens on |
| autoStart | boolean | No | Start when DevDock launches |
| autoRestart | boolean | No | Auto-restart on crash |
Auto-Start
When autoStart is enabled, the service will automatically begin running when you open DevDock. This is useful for services you always need, like your main development server.
Auto-Restart
When autoRestart is enabled, DevDock will automatically restart the service if it crashes unexpectedly. The restart uses an exponential backoff strategy to avoid rapid restart loops:
- 1st restart: immediate
- 2nd restart: 1 second delay
- 3rd restart: 2 second delay
- 4th restart: 4 second delay
- Maximum delay: 30 seconds
Port Configuration
Setting a port number enables several features:
- Port conflict detection: DevDock checks if the port is already in use
- Automatic port reassignment: If a conflict is detected, a free port is assigned
- Browser auto-launch: DevDock can open the service in your browser when the port becomes ready