Введение
Joppa берёт на себя ваши локальные проекты целиком: домены .test по HTTPS, базы данных, worktree, туннели, ИИ-ассистент. В этой документации описано всё, что он делает, и как.
Joppa — настольное приложение для macOS и Linux, которое заменяет ручную настройку локальной среды разработки. Вы указываете ему папку; он находит запускаемые в ней серверы разработки, даёт каждому адрес https://, похожий на продакшен, и запускает нужные проекту базы данных — в том Docker, Podman, OrbStack или Colima, который у вас уже есть.
localhost:5173 → https://app.acme.test 🔒
localhost:8000 → https://api.acme.test 🔒
postgres (контейнер) → 127.0.0.1:5432 · база acme · pgvector
С чего начать
Что умеет Joppa
Для ваших проектов

- Домены
.testпо HTTPS: по домену на каждый сервер разработки (app.myproject.test,api.myproject.test) с доверенным сертификатом. - Процессы: Joppa запускает ваши серверы разработки и контейнеры Compose в нужном порядке, со встроенным терминалом и перезапуском после сбоя.
- Переменные окружения: файл
.envподдерживается в актуальном состоянии с учётом доменов и сервисов, и перед каждой записью показывается diff. - Версии Node, bun и PHP, закреплённые за проектом.
- Аналитика: запросы, задержка, ошибки и доступность ваших серверов разработки (Joppa Pro).
- Инспектор запросов: заголовки и тело каждого запроса, повтор как есть или с изменениями, копирование в виде cURL (Joppa Pro).
- Журнал событий Reverb: подключения, подписки и рассылки по проектам и worktree, включая те, которые никто не получил (Joppa Pro).
- Новый проект из шаблона: Vite+, Next.js, Nuxt, Astro, SvelteKit, Laravel или репозиторий GitHub.
- Перенос из Lerd, Herd, DDEV или Sail: ваши сайты, их домены, базы данных и
.envпереносятся за один раз.
Для ваших сервисов
- Базы данных: PostgreSQL (с pgvector, PostGIS…), MySQL и MariaDB, по базе данных на проект.
- Кеш, почта, поиск и broadcasting: Mailpit, а с Joppa Pro — Redis, Valkey, Typesense, Meilisearch и Reverb.
- Импорт из Docker Compose: ваши данные копируются в Joppa, источник остаётся нетронутым.
Везде
- Команда
joppa, полноэкранное приложение в терминале и MCP-сервер для Claude и Cursor. - Палитра ⌘K и сочетание клавиш для каждого действия.
Поддерживаемые системы
| Система | Состояние |
|---|---|
| macOS | Доступно (Apple Silicon и Intel) |
| Linux | Доступно (.AppImage, .deb и пакет joppa-bin для Arch) |
| Windows | В разработке |
Joppa бесплатен: неограниченное число проектов, PostgreSQL, MySQL, MariaDB и Mailpit. Joppa Pro добавляет аналитику, инспектор запросов, журнал событий Reverb, Redis, Valkey, Typesense, Meilisearch и Reverb, а также несколько серверов одного движка; тариф Team даёт всё это каждому участнику.