Damp

Migrate from DDEV

Switch from DDEV to DAMP

Migration Steps

Stop DDEV

Stop all DDEV containers:

# In your project directory
ddev stop

# Or remove completely
ddev delete -O

Add Project to DAMP

  1. Launch DAMP
  2. Click "Add Project"
  3. Select "Existing Project"
  4. Configure:
    • Name: Your project name
    • Path: Your project folder
    • PHP Version: Match .ddev/config.yaml (check php_version)

Install Services

Check your .ddev/config.yaml and install equivalent services:

  • MySQL - For database (db service with MySQL)
  • PostgreSQL - For database (db service with PostgreSQL)
  • Redis - For caching/queues (redis addon)
  • Mailpit - For email testing (mailhog equivalent)

Go to Services page → Click "Install" for each service.

Migrate Database (Optional)

If you have existing data, export and import:

Option 1: Command Line

# Export from DDEV
ddev export-db --file=backup.sql.gz

# Import to DAMP (inside VS Code DevContainer)
gunzip < backup.sql.gz | mysql -h damp-mysql -u damp -pdamp damp

# Or if uncompressed SQL
mysql -h damp-mysql -u damp -pdamp damp < backup.sql

Option 2: GUI Tools

Use database management tools like TablePlus, DBeaver, or HeidiSQL:

  1. Export from DDEV: Connect to localhost:3306, export database as SQL
  2. Import to DAMP: Get MySQL port from DAMP Services page, connect to localhost:{port}, import SQL file

Connection details for DAMP MySQL:

  • Host: localhost
  • Port: Check DAMP app (Services page)
  • Username: damp
  • Password: damp
  • Database: damp

Update Configuration

Open project in VS Code DevContainer and update .env:

# Update database connection
DB_HOST=damp-mysql
DB_DATABASE=damp
DB_USERNAME=damp
DB_PASSWORD=damp

# Update Redis (if using)
REDIS_HOST=damp-redis

# Update Mail (if using)
MAIL_HOST=damp-mailpit
MAIL_PORT=1025

Clean Up DDEV Files (Optional)

After verifying everything works, you can remove:

.ddev/

Update .gitignore to remove .ddev reference.

Test Project

  1. Click "Open in VS Code" in DAMP
  2. Reopen in Container when prompted
  3. Browse to https://yourproject.local
  4. Install SSL certificate if prompted

Configuration Changes

Generated Files

DAMP adds these files to your project:

your-project/
├── .devcontainer/
│   └── devcontainer.json
├── .vscode/
│   └── launch.json
├── Dockerfile
├── docker-compose.yml
└── .dockerignore

Service Hostnames

Service names are automatically generated by Docker. Get actual service names and ports from the DAMP app (Services page).

Default pattern:

ServiceDDEVDAMP
Databasedbdamp-mysql
Redisredisdamp-redis
Maillocalhost:1025damp-mailpit

Domain Format

ToolFormat
DDEVhttps://project.ddev.site
DAMPhttps://project.local

Commands

TaskDDEVDAMP
Startddev startAutomatic in DevContainer
SSHddev sshUse VS Code terminal
Composerddev composercomposer
Artisanddev artisanphp artisan
npmddev npmnpm
MySQLddev mysqlmysql -h damp-mysql

Run commands directly in DevContainer (no wrapper needed).

Troubleshooting

On this page