Services

Install and manage development services from DAMP. All services run in Docker containers on the damp-network network.

Available Services

DAMP provides 14 pre-configured services for development.

Web Servers

Databases

Caching

Search Engines

Email & Storage

Message Queues

Service Features

• Install, start, stop, and remove via DAMP interface
• Connection info displayed in DAMP (host and container connections)
• Default configuration with sensible environment variables
• Data persistence via Docker named volumes
• Port mapping to host machine (dynamic if defaults are occupied)

┌──────────────────────────────────────────┐
│   DAMP Services Page                     │
│   [Install Service Button]               │
└─────────────┬────────────────────────────┘
              │
              ↓
┌──────────────────────────────────────────┐
│   Docker Container Created               │
│   - Named volumes for data               │
│   - Connected to damp-network            │
│   - Ports exposed to host                │
└─────────────┬────────────────────────────┘
              │
              ↓
┌──────────────────────────────────────────┐
│   Service Running                        │
│   Connection details shown in DAMP       │
└──────────────────────────────────────────┘

Container Identification

DAMP identifies service containers using Docker labels, not container names.

• Container names are auto-generated by Docker
• DAMP queries containers by labels: com.pickleboxer.damp.service-id
• Connection information (container name) is displayed in DAMP interface

Connection Methods

From Project Containers (DevContainers)

Use the container name shown in DAMP interface:

# Example: Replace [container-name] with actual name from DAMP
mysql -h [container-name] -u developer -p
redis-cli -h [container-name]

All containers communicate via the damp-network Docker network.

From Host Machine (Windows)

Use localhost with the port shown in DAMP:

# Use localhost and actual port from DAMP interface
mysql -h localhost -P 3306 -u developer -p
redis-cli -h localhost -p 6379

If the default port is occupied, DAMP uses the next available port automatically.

Port Configuration

Default ports are attempted first. If occupied, DAMP finds the next available port.

Example:

• Service: MySQL (default port 3306)
• If 3306 is occupied → DAMP uses 3307 (or next available)
• Actual port is shown in DAMP interface

Check DAMP for the actual port assigned to each service.

Managing Services

Install

Click "Install Service" in DAMP to:

1. Pull Docker image
2. Create named volumes for data
3. Create and start container
4. Display connection information

Start/Stop

• Start - Starts a stopped service
• Stop - Stops a running service (data persists)

Remove

Removes the container. Data volume is preserved.

Service Status

• 🟢 Running - Service is active
• 🔴 Stopped - Service installed but not running
• ⚪ Not Installed - Service not installed

Learn More

Visit individual service pages for:

• Docker configuration (image, ports, volumes)
• Credentials and environment variables
• Connection strings
• Data persistence information