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 -OAdd Project to DAMP
- Launch DAMP
- Click "Add Project"
- Select "Existing Project"
- Configure:
- Name: Your project name
- Path: Your project folder
- PHP Version: Match
.ddev/config.yaml(checkphp_version)
Install Services
Check your .ddev/config.yaml and install equivalent services:
- MySQL - For database (
dbservice with MySQL) - PostgreSQL - For database (
dbservice with PostgreSQL) - Redis - For caching/queues (
redisaddon) - Mailpit - For email testing (
mailhogequivalent)
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.sqlOption 2: GUI Tools
Use database management tools like TablePlus, DBeaver, or HeidiSQL:
- Export from DDEV: Connect to
localhost:3306, export database as SQL - 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=1025Clean Up DDEV Files (Optional)
After verifying everything works, you can remove:
.ddev/Update .gitignore to remove .ddev reference.
Test Project
- Click "Open in VS Code" in DAMP
- Reopen in Container when prompted
- Browse to
https://yourproject.local - 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
└── .dockerignoreService Hostnames
Service names are automatically generated by Docker. Get actual service names and ports from the DAMP app (Services page).
Default pattern:
| Service | DDEV | DAMP |
|---|---|---|
| Database | db | damp-mysql |
| Redis | redis | damp-redis |
localhost:1025 | damp-mailpit |
Domain Format
| Tool | Format |
|---|---|
| DDEV | https://project.ddev.site |
| DAMP | https://project.local |
Commands
| Task | DDEV | DAMP |
|---|---|---|
| Start | ddev start | Automatic in DevContainer |
| SSH | ddev ssh | Use VS Code terminal |
| Composer | ddev composer | composer |
| Artisan | ddev artisan | php artisan |
| npm | ddev npm | npm |
| MySQL | ddev mysql | mysql -h damp-mysql |
Run commands directly in DevContainer (no wrapper needed).