Configuration

Adding Services

Adding Services

Services are the core of DevDock. Each service represents a local development process you want to manage.

Adding a Service via the UI

  1. Click the + Add Service button on the Services page
  2. Fill in the required fields:
    • Name: A friendly name for your service (e.g., "Frontend", "API Server")
    • Command: The shell command to start the service (e.g., npm run dev)
    • Working Directory: The absolute path to the project root
  3. Optionally configure:
    • Port: The port number the service will listen on
    • Auto Start: Whether to start this service when DevDock launches
    • Auto Restart: Whether to automatically restart if the service crashes

Example Configurations

React Development Server:

json
{
  "name": "Frontend",
  "command": "npm run dev",
  "cwd": "/Users/dev/my-app/frontend",
  "port": 3000,
  "autoStart": true,
  "autoRestart": true
}

Express API Server:

json
{
  "name": "API Server",
  "command": "npm run dev",
  "cwd": "/Users/dev/my-app/backend",
  "port": 4000,
  "autoStart": true,
  "autoRestart": true
}

Database (Docker):

json
{
  "name": "PostgreSQL",
  "command": "docker-compose up postgres",
  "cwd": "/Users/dev/my-app",
  "port": 5432,
  "autoStart": false,
  "autoRestart": false
}