Перенос из Lerd, Herd, DDEV или Sail

Уже пользуетесь Lerd, Laravel Herd, DDEV или Laravel Sail? Перенос в Joppa переносит ваши сайты за один раз: каждый сайт становится проектом Joppa со своим доменом .test по HTTPS, его базы данных копируются в сервисы Joppa, а его .env направляется на Joppa. Старый инструмент только читается: его файлы и базы данных никогда не меняются, а останавливается он, только если вы попросите.

Откройте перенос:

с главного экрана при первом запуске: Перенести из Lerd, Herd, DDEV или Sail…;
в Настройки › Перенос в Joppa;
из палитры ⌘ K: «Перенести из Lerd, Herd, DDEV или Sail…»;
из баннера прокси, когда порт 443 занят Lerd, Herd, DDEV или Sail: Перенести его сайты в Joppa… (см. Порты 80 и 443 заняты).

1. Найденные сайты

Joppa ищет сайты каждого инструмента там, где тот их хранит:

Перенос в Joppa: сайты Laravel Herd, Lerd, DDEV и Laravel Sail, найденные на этом Mac

Инструмент	Где смотрит Joppa	Базы данных
Lerd	`lerd sites`, его файл сайтов и `.lerd.yaml` в каждом проекте	Его контейнеры Podman (`lerd-mysql`, `lerd-postgres`) с учётными данными из `.env` проекта
Laravel Herd	Его конфигурация: припаркованные папки (каждая вложенная папка — сайт) и ссылки (`herd link`)	Сервисы Herd Pro на вашем компьютере (`DB_HOST` и `DB_PORT` из `.env`)
DDEV	`~/.ddev/project_list.yaml` и `.ddev/config.yaml`	Контейнер `ddev-<проект>-db`
Laravel Sail	Работающие контейнеры `laravel.test` и файлы `docker-compose.yml` с сервисом `laravel.test`	Сервисы MySQL, MariaDB или PostgreSQL из файла Compose

Joppa также просматривает ваши привычные папки с кодом (~/Code, ~/Sites, ~/Projects, ~/Herd…) на один уровень вглубь. Проект лежит в другом месте? Добавить папку… прочитает его.

Для каждого сайта показаны его домены, папка, базы данных и версия PHP. Сайты, которых ещё нет в Joppa, отмечены; те, что уже есть, помечены «уже в Joppa». Отметьте сайты для переноса, затем нажмите Подготовить план.

2. План

Для каждого сайта, прежде чем что-либо изменится:

Домен: домен инструмента, если он уже в .test (Lerd, Herd), иначе <имя>.test (blog.ddev.site становится blog.test). Если он уже занят в Joppa — blog-2.test. Он маршрутизируется на 127.0.0.1:8000, порт php artisan serve, или на сервер разработки, который Joppa обнаружит у проекта не на Laravel.
Каждая база данных: её движок и версия, размер, откуда она читается, и сервис Joppa, который её примет («→ MySQL 8.4 в Joppa · shop»). Если подходящего сервиса нет, Joppa создаёт его — в версии источника, если Joppa её предлагает, и на свободном порту («→ новый сервис PostgreSQL 17 (порт 5433)»). База данных с таким именем уже есть? Используется первое свободное имя (shop_import).
Файл .env: diff того, что изменится (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD, APP_URL на https://), с кнопкой Показать изменения.

Три флажка для каждого сайта:

План переноса: домен, база данных, скопированная в MySQL, diff файла .env, остановка старого инструмента

Флажок	Действие
Скопировать базы данных	Копирует каждую базу данных в её сервис Joppa, как импорт из Docker Compose: выгрузка клиентом источника, создание базы данных, восстановление, затем сравнение числа таблиц
Направить .env на Joppa	Записывает `.env`, показанный в diff. Оригинал сохраняется как `.env.joppa-backup`
Затем остановить …	Останавливает старый инструмент после переноса сайта: `lerd stop`, `herd stop`, `ddev stop <проект>`, `./vendor/bin/sail stop`

3. Перенос

Перенести N сайтов выполняет шаги сайт за сайтом, показывая их ход: проект, базы данных, .env, остановка. Неудавшийся шаг не останавливает остальные; итоговый отчёт сообщает для каждого сайта, что было сделано или почему не получилось, с кнопкой Открыть для перехода к проекту. Повторный перенос уже перенесённого сайта использует его существующий проект.

Если старый инструмент был остановлен, а прокси Joppa не работал (порт 443 был занят инструментом), Joppa в конце запускает свой прокси.

Что остаётся как есть

Файлы проекта, кроме .env, если вы отметили этот флажок (перед этим он сохраняется).
Базы данных старого инструмента: они только читаются.
Конфигурация старого инструмента (его сайты, ссылки, DNS). Если вы оставите Lerd, Herd или Valet, их разрешение .test продолжит работать и для Joppa; если вы их удалите, Joppa предложит установить своё (см. Разрешение доменов .test).