Перейти к содержанию

Docker / Docker Compose

Synth поставляется готовым образом gitverse.ru/itphx/synth и файлом docker-compose.yml. Это самый простой способ развернуть платформу, если не хочется устанавливать Node.js: образ уже содержит и core, и веб-интерфейс.

Быстрый запуск образа

docker run -p 4300:4300 \
  -e SYNTH_API_KEY=my-secret-key \
  -v synth-data:/var/synth/data \
  gitverse.ru/itphx/synth

Откройте http://localhost:4300 и введите ключ my-secret-key. Образ сам слушает 0.0.0.0:4300 и хранит данные в томе /var/synth/data.

Docker Compose

Готовый docker-compose.yml лежит в корне репозитория. Он поднимает Synth, а Ollama вынесена в отдельный профиль.

git clone https://gitverse.ru/itphx/synth && cd synth

echo "SYNTH_API_KEY=my-secret-key" > .env

docker compose up -d

Откройте http://localhost:4300 и введите ключ my-secret-key. Логи сервиса: docker compose logs -f synth.

Состав Compose

Сервис Порт Назначение
synth 4300 Платформа целиком: core + UI, данные в томе synth-data
ollama (профиль ollama) 11434 Локальный сервер моделей, данные в томе ollama-data

Compose уже настроен на работу с Ollama внутри сети Docker: провайдер указывает на http://ollama:11434/v1.

Переменные окружения

Переменная Обязательна Назначение
SYNTH_API_KEY да Ключ доступа к UI и API
SYNTH_PROVIDER_OLLAMA_URL для Ollama Адрес OpenAI-совместимого API Ollama
SYNTH_PROVIDER_OLLAMA_MODEL для Ollama Модель, например qwen3.5
SYNTH_PROVIDER_OLLAMA_TYPE для Ollama Тип провайдера — ollama
SYNTH_PROVIDER_<NAME>_API_KEY для внешних API Ключ провайдера

Провайдеры можно задать и через CLI/UI уже после запуска — подробности в Провайдеры и модели.

Ollama в Compose

Локальные модели одной командой

Запустите профиль и загрузите модель:

docker compose --profile ollama up -d
docker compose exec ollama ollama pull qwen3.5

После этого Ollama доступна приложению по адресу http://ollama:11434/v1, а наружу — на http://localhost:11434.

Данные и тома

Данные Synth живут в именованном томе synth-data (внутри — /var/synth/data): сессии, проекты, провайдеры, модели, агенты, секреты. Модели Ollama — в томе ollama-data.

  • docker compose down останавливает сервисы, но сохраняет тома.
  • docker compose down -v удаляет тома вместе с данными — используйте осознанно.
  • Список томов: docker volume ls.

Обновление версии

# Compose собирает образ из исходников репозитория
git pull
docker compose up -d --build

# для образа, запущенного вручную
docker pull gitverse.ru/itphx/synth:latest
docker rm -f synth
# затем запустите контейнер заново

Обновление не затрагивает тома, поэтому история и настройки сохраняются. Для предсказуемых развёртываний фиксируйте конкретный тег вместо latest.

Один контейнер — вся платформа

Образ содержит и backend-движок, и собранный SPA. Отдельные контейнеры для UI или раннера не нужны.

Что дальше