> ## Documentation Index
> Fetch the complete documentation index at: https://herd.laravel.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating from Laragon

# Migrating from Laragon to Herd

While Laragon and Herd are both development environments for PHP and Laravel, they have some key differences in their approach. This guide helps you migrate your existing Laragon setup to Herd while maintaining your productivity and existing projects.

## Key Differences

Here are the main differences between Laragon and Herd:

* Herd is tailored to Laravel, mirroring standard deployment setups closely
* Herd manages PHP versions automatically
* Herd comes with [nvm](/windows/advanced-usage/node-versions) for Node.js version management
* Herd (Pro) ships with debugging tools and a common services

## Before You Start

Before migrating to Herd, make sure to:

1. Document your current Laragon setup (PHP versions, database names, etc.)
2. Export any important databases
3. Shutdown Laragon
4. [Install Herd](/windows/getting-started/installation)

## Directory Structure

While Laragon keeps all projects in its `www` directory by default, Herd uses the concept of [parked paths](/windows/getting-started/sites). By default, Herd creates and uses `%USERPROFILE%\Herd` as the parked directory.

You have two options for your existing projects:

1. Move them to the Herd directory
2. Add your Laragon `www` directory as a parked path in Herd

### Option 1: Moving Projects

1. Copy your projects from the Laragon `www` directory to `%USERPROFILE%\Herd`
2. Each project will automatically be available via `http://directory-name.test`

### Option 2: Adding Laragon Directory

1. Open Herd settings
2. Go to "General" settings
3. Add your Laragon `www` directory to the parked paths
4. All projects in that directory will be available via `http://directory-name.test`

## PHP Versions

Herd manages PHP versions differently than Laragon. Instead of downloading PHP versions manually, Herd provides an easy interface to install and manage PHP versions:

1. Open Herd settings
2. Go to "PHP" settings
3. Install the PHP versions you need
4. [Isolate projects](/windows/advanced-usage/php-versions#per-site-php-versions) to specific PHP versions if needed

## Database Migration

### MySQL

If you're using MySQL databases in Laragon, you'll need to:

1. Export your databases from Laragon's MySQL
2. Set up MySQL in Herd (via [Herd Pro](/windows/herd-pro-services/mysql) or [dbngin](https://dbngin.com/))
3. Import your databases into the new MySQL instance

#### Exporting from Laragon

```bash theme={null}
# Using mysqldump from Laragon's MySQL
cd C:\laragon\bin\mysql\mysql-{version}\bin
mysqldump -u root --all-databases > all_databases.sql
```

#### Importing to Herd

If you're using Herd Pro:

1. Install MySQL via the [Services](/windows/herd-pro-services/mysql) tab or via [dbngin](https://dbngin.com/)
2. Use TablePlus or AdminerEvo to import your databases
3. Update your projects' `.env` files with the new database credentials:

```env theme={null}
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3307 # Default Herd Pro MySQL port
DB_DATABASE=your_database
DB_USERNAME=root
DB_PASSWORD=
```

### PostgreSQL

If you're using PostgreSQL, the process is similar:

1. Export your databases from Laragon's PostgreSQL
2. Set up PostgreSQL in [Herd Pro](/windows/herd-pro-services/postgresql) or standalone
3. Import your databases
4. Update your connection settings

```nginx theme={null}
# Nginx equivalent
location / {
    try_files $uri $uri/ /public/index.php?$query_string;
}
```

## SSL Certificates

If you're using SSL certificates in Laragon:

1. Note which sites need HTTPS
2. Use the [secure sites](/windows/advanced-usage/securing-sites) feature in Herd
3. Run `herd secure` for each site needing HTTPS

```bash theme={null}
cd %USERPROFILE%\Herd\your-project
herd secure
```

## Node.js and NPM

Herd includes [nvm](/windows/advanced-usage/node-versions) for Node.js version management:

1. Install needed Node.js versions via Herd settings
2. Optionally [isolate projects](/windows/advanced-usage/node-versions#per-site-node-versions) to specific Node.js versions

## Mail Testing

If you used Laragon's built-in mail features:

1. Configure Herd's [mail service](/windows/herd-pro/mail) (Herd Pro)
2. Update your `.env` files with the new mail settings

```env theme={null}
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=${APP_NAME}
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
```

## Troubleshooting

If you encounter issues during migration:

1. Check the [common issues](/windows/troubleshooting/common-issues) section
2. Verify file permissions
3. Check the [Herd logs](/windows/troubleshooting/common-issues#herd-debug-logs)
4. Make sure old Laragon services aren't running

## Running Both Side by Side

During migration, you can run both Herd and Laragon, but:

1. Don't run them simultaneously
2. Stop all services in one before starting the other
3. Watch for port conflicts, especially with databases

## Final Steps

After migrating:

1. Test all your applications thoroughly
2. Update documentation and deployment scripts
3. Consider uninstalling Laragon once everything works
4. Set up [Herd Pro features](/windows/herd-pro/dumps) like Dumps and Log Viewer

For detailed information about specific features or troubleshooting, consult the relevant sections of the Herd documentation.