Файлы

Папка Joppa

Система	Расположение
macOS	~/Library/Application Support/joppa
Linux	~/.config/joppa

Файл или папка	Содержимое
config.json	Проекты, домены, сервисы и настройки
processes.json	Процессы проектов, если их нет в joppa.toml, и процессы окружений worktree
team.json	Для каждого проекта — joppa.toml в том виде, в каком этот компьютер последним его применил (или проигнорировал): Joppa сообщает, что в нём меняет git pull
running.json	Работающие серверы разработки, запущенные Joppa, чтобы найти их, если Joppa закроется, не остановив их
control.json	Порт и токен локального API для команды joppa (доступен для чтения только вам)
reporter.json	Подтверждённый адрес для Сообщить об ошибке и его токен, действительный 30 дней (доступен для чтения только вам)
telemetry.json	Ваш выбор в разделе Конфиденциальность и случайный идентификатор статистики
crashes/	Ещё не отправленные отчёты о сбоях (только если включено Отправлять отчёты о сбоях)
logs/	Логи Joppa: joppa.log и joppa.1.log сверх 5 МБ (доступны для чтения только вам)
ca/	Центр сертификации: rootCA.pem и его ключ rootCA-key.pem (только для чтения)
snapshots/<volume>/<base>/	Снимки баз данных (Joppa Pro): .dump (PostgreSQL) или .sql.gz (MySQL, MariaDB) и .json для каждого снимка; самые старые удаляются сверх значения Хранить на базу
analytics/	Статистика по доменам, одна строка в минуту, хранится 7 дней
build/<движок>-<версия>/	Рецепты образов, собираемых локально: PostgreSQL с расширениями, Reverb (его Dockerfile и AppServiceProvider.php от Joppa, который даёт приложение каждому проекту и ведёт журнал событий)
php/<версия>/	Скачанные сборки PHP
php/xdebug/<8.x>/	Xdebug для версии PHP: xdebug.so, загружающий его xdebug.ini и joppa.json (версия, контрольная сумма)
bin/	Команды php и composer, которые следуют .php-version
share/cloudflared	cloudflared, если он был скачан кнопкой Скачать cloudflared для публичной ссылки (отпечаток SHA-256 проверяется)
share/known_hosts	Ключи хостов localhost.run и Pinggy для их туннелей ssh

Лицензии в этой папке нет: она хранится в связке ключей системы (сервис com.getjoppa.license), как и токен ngrok, если он сохранён (сервис com.getjoppa.ngrok).

В ваших проектах

Joppa записывает в проект только то, что вы подтвердили:

Файл	Когда
.env	Связывание сервиса, HTTPS-адреса, редактирование (всегда с diff)
.env.joppa-backup	Копия исходного .env при первой записи (в том числе при переносе)
.env.testing, phpunit.xml	Laravel: если вы подключаете тестовую базу данных (только DB_*)
.env.testing.joppa-backup, phpunit.xml.joppa-backup	Исходные копии этих файлов при первой записи
joppa.toml	Если вы делитесь конфигурацией проекта с командой (см. joppa.toml)
.node-version, package.json	Если вы закрепляете Node или менеджер пакетов
.php-version	Если вы закрепляете PHP
.php.ini	Если вы записываете php.ini проекта
vite.config.*, astro.config.*	Если вы нажимаете Исправить файл

В worktree, который готовит Joppa: недостающие файлы .env, .env.local, .env.development(.local), .dev.vars и .php.ini, скопированные из проекта с адресами worktree. Новый worktree создаёт свою папку рядом с репозиторием, в <проект>-worktrees/.

За пределами этих папок

• Профиль оболочки (~/.zshrc…): только блоки # >>> Joppa (PHP) >>> и # >>> Joppa (Node) >>>, если вы их включаете.
• Vite+: устанавливается при первом запуске в свои обычные папки (~/.local/share/vite-plus и ~/.config/vite-plus или ~/.vite-plus, если он уже был там) вместе с Node LTS и bun. Joppa обновляет его каждый день.
• Разрешение .test: файл, который направляет *.test на DNS-сервер Joppa (127.0.0.1:15353), записывается с вашим паролем: /etc/resolver/test в macOS, /etc/systemd/resolved.conf.d/joppa.conf или /etc/NetworkManager/dnsmasq.d/joppa.conf в Linux. Он начинается со строки # Joppa. См. Разрешение доменов .test.
• Команда joppa: ссылка в /usr/local/bin или ~/.local/bin, если вы её устанавливаете.
• Ассистенты: запись mcpServers.joppa в их конфигурации, если вы их подключаете.
• Контейнеры: joppa-<движок> и их тома joppa-<движок>-<версия> в вашей среде выполнения.

Удалить всё

Настройки › Удаление › Удалить Joppa… показывает всё, что Joppa установил на этот компьютер; отметьте, что удалить:

Элемент	Что удаляется
MCP-сервер ассистентов	Запись mcpServers.joppa из Claude Code, Claude Desktop и Cursor
Команда joppa	Ссылки joppa в /usr/local/bin или ~/.local/bin
PHP и Node в профиле оболочки	Блоки # >>> Joppa (PHP) >>> и # >>> Joppa (Node) >>> из ~/.zshrc, ~/.bash_profile, ~/.bashrc и joppa.fish
Контейнеры сервисов	Контейнеры joppa-<движок> и образы, которые Joppa собрал для расширений
Данные сервисов	Тома joppa-<движок>-<версия>: базы данных, письма, индексы (по умолчанию флажок снят)
Доверие к CA	CA «Joppa local CA» удаляется из вашей связки ключей сеанса (ваш пароль) или из системной связки ключей, если её туда добавила команда из терминала (пароль администратора)
Разрешение .test	Файл резолвера Joppa (/etc/resolver/test…), с вашим паролем. Файл другого инструмента (Herd, Valet, dnsmasq) остаётся
Лицензия	Место этого Mac освобождается, а ключ удаляется из связки ключей
Папка Joppa	Папка выше и данные окна (~/Library/WebKit/dev.joppa.app, кеши…)
Приложение	Joppa.app (macOS) или файл .AppImage (Linux)

Папка Joppa и приложение удаляются после закрытия Joppa: поэтому кнопка становится Удалить и выйти. Файлы ваших проектов (.env, .env.joppa-backup, joppa.toml…) никогда не трогаются.

Из терминала то же самое делает joppa uninstall: см. Команда joppa › Удаление.

Шаг, который не удался (пароль не введён, среда выполнения остановлена, нет сети, чтобы освободить лицензию), отмечается, но не блокирует остальные. Чтобы выполнить его вручную: docker rm -f joppa-postgres, docker volume rm joppa-postgres-17, а в macOS — «Связка ключей» › вход (или «Система») › «Joppa local CA».