Migrate from Laravel Herd
Switch from Herd to DAMP
Migration Steps
Stop Herd Services
Free ports 80 and 443:
- Open Laravel Herd
- Click "Stop All Services"
- Quit Herd completely
Add Project to DAMP
- Launch DAMP
- Click "Add Project"
- Select "Existing Project"
- Configure:
- Name: Your project name
- Path: Your project folder (e.g.,
C:\Herd\my-app) - PHP Version: Match your current version
Install Services
Go to Services page and install required services:
- MySQL - For database
- Redis - For caching/queues
- Mailpit - For email testing
Migrate Database (Optional)
If you have existing data, export and import:
Option 1: Command Line
# Export from Herd MySQL
mysqldump -u root -p your_database > backup.sql
# Import to DAMP (inside VS Code DevContainer)
mysql -h damp-mysql -u damp -pdamp damp < backup.sqlOption 2: GUI Tools
Use database management tools like TablePlus, DBeaver, or HeidiSQL:
- Export from Herd: 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=1025Test 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 | Herd | DAMP |
|---|---|---|
| Database | 127.0.0.1 | damp-mysql |
| Redis | 127.0.0.1 | damp-redis |
127.0.0.1 | damp-mailpit |
Domain Format
| Tool | Format |
|---|---|
| Herd | http://project.test |
| DAMP | https://project.local |
Commands
Run commands directly in DevContainer (no wrapper needed):
php artisan migrate
composer install
npm run dev