Обзор сервисов

Сервис — это сервер, общий для ваших проектов, который Joppa запускает в вашей среде контейнеров. Откройте Сервисы на боковой панели: на странице сначала перечислены ваши сервисы, затем каталог.

Каталог

Сервис	Версии	Порт по умолчанию	Учётная запись или ключ
PostgreSQL	18, 17, 16, 15, 14	5432	postgres / postgres
MySQL	9.7, 8.4, 8.0	3306	root / root
MariaDB	12.3, 11.8, 11.4, 10.11	3306	root / root
Redis	8.10, 8.8, 7.4	6379	—
Valkey	9.2, 9.1, 8.1	6379	—
Mailpit	1.31	SMTP 1025, веб-интерфейс 8025	—
Typesense	30.2, 29.1	8108	API-ключ, свой у каждого сервера (joppa-…)
Meilisearch	1.55, 1.54	7700	мастер-ключ, свой у каждого сервера (joppa-…)
Reverb	1.12, 1.11, 1.10	WebSocket 6001, журнал событий 6002	отдельное приложение для каждого проекта, ключи выводятся из ключей сервера

Первая версия в списке предлагается по умолчанию.

Добавить сервис

Нажмите + Добавить PostgreSQL (или другой сервис) в каталоге. Выберите версию и порт: Joppa предлагает первый свободный порт начиная с порта по умолчанию (MariaDB, добавленная рядом с MySQL, получит 3307). Сервис запускается в контейнере с именем joppa-<движок>.

Все сервисы слушают только 127.0.0.1: из сети они не видны.

Бесплатная версия и Joppa Pro

Бесплатная версия включает PostgreSQL (с его расширениями), MySQL, MariaDB и Mailpit, по одному серверу каждого. У Redis, Valkey, Typesense, Meilisearch и Reverb в списке добавляемых сервисов стоит значок Pro; несколько серверов одного движка (например, два PostgreSQL) тоже требуют Joppa Pro. Импорт и экспорт баз данных бесплатны; их снимки требуют Joppa Pro.

В бесплатной версии при открытии такого сервиса появляется сообщение, сохранение недоступно, а рядом кнопка Узнать о Joppa Pro:

• «Redis входит в Joppa Pro. Бесплатная версия включает PostgreSQL, MySQL, MariaDB и Mailpit.»
• «Бесплатная версия включает один сервер PostgreSQL. Перейдите на Joppa Pro, чтобы добавить больше.»

Страница сервиса

• Запустить / Остановить и сколько времени сервис уже работает.
• Копировать URL сервера (или адрес, API-ключ, мастер-ключ — в зависимости от сервиса).
• Открыть в TablePlus для баз данных и кэшей, Открыть ящик для Mailpit, Открыть предпросмотр для Meilisearch.
• Проекты: проекты, которые его используют, Подключить проект и Отключить. Joppa записывает адрес сервиса в их .env и поддерживает его в актуальном состоянии.
• Входящие (Mailpit): полученные письма, с поиском и отображением HTML, не выходя из Joppa; см. Почтовый ящик в Joppa.
• Ресурсы: CPU, память, сеть и диск контейнера, замеры каждые 5 с, пока страница открыта, с графиком за последние пять минут. 100 % CPU — это одно ядро целиком.
• логи: логи контейнера на всю ширину, с кнопкой Следить. Для PostgreSQL — по вкладке на каждую базу (Все, по одной на базу, Сервер для строк самого сервера): Joppa настраивает log_line_prefix, чтобы в каждой строке было имя её базы. Кнопка Спросить Claude Code вверху справа отправляет весь показанный лог (последние 80 строк на выбранной вкладке) вашему агенту для программирования; или выделите строки, чтобы отправить их агенту или скопировать вместе с сервисом, базой и проектами, которые её используют; см. Ассистент.
• Меню Действия: Версия и порт… (или Версия, порт и расширения… для PostgreSQL) и Удалить сервис….

Смена версии или порта

Изменения применяются при следующем запуске; на странице появляется кнопка ↻ Применить изменения (контейнер создаётся заново, данные остаются).

• У каждой версии свои данные — в отдельном томе (joppa-postgres-17). Переход с 17 на 18 запускает пустой сервер; при возврате на 17 её базы данных снова на месте.
• Смена порта обновляет .env связанных проектов.

Удаление сервиса

Удалить сервис… удаляет контейнер. Данные остаются в томе: если снова добавить тот же сервис, они вернутся.

Порт занят

Если порт уже занят, на странице появляется «✕ Порт 5432 занят: …» и два варианта: Сменить порт или Освободить порт. Joppa определяет виновника и предлагает подходящее действие:

Кто занимает порт	Предлагаемое действие
Контейнер Docker, Compose или Lerd	Остановить его
Сервис Homebrew	brew services stop … (он больше не будет запускаться при входе в систему)
Postgres.app	Из Joppa невозможно: нажмите «Stop» в Postgres.app
Другой процесс	Остановить его напрямую, после подтверждения