На этой странице
Видео: первый проект и выкладка1:16

В панели#

  1. Источник

    Сервис → «Настройки» → «Источник»: GitHub (репозиторий и ветка), Hangar Git или Docker-образ. Для GitHub и Hangar Git каждый push в ветку деплоится сам.

  2. Деплой вручную

    В обзоре сервиса — кнопка «Деплой». Логи сборки открываются сразу и обновляются вживую.

  3. История и откат

    Вкладка «Деплои»: все версии со статусом (Активный, Успешно, Заменён, Ошибка). У прошлой версии — «Откатить сюда»: запустится её образ с её конфигурацией и переменными.

История деплоев
Вкладка «Деплои»: активная версия и предыдущие.
Настройки сервиса
Настройки сервиса: название и иконка, источник (GitHub, Hangar Git, Docker-образ), запуск, ресурсы, сеть, статический IP.

Логотип технологии#

При каждой сборке Hangar смотрит в код — package.json, composer.json, requirements.txt, go.mod, Gemfile, Dockerfile — и определяет, на чём написан сервис: Next.js, Nuxt, NestJS, Express, Laravel, Symfony, Yii, WordPress, Django, FastAPI, Flask, Telegram-бот на aiogram или grammY, Go, Rails, Spring и ещё сотню вариантов. Логотип появляется на схеме проекта, в списке проектов и на главной, а в шапке сервиса — подпись вроде «Laravel · PHP 8.3».

Логотипы технологий на схеме проекта
Схема проекта: у каждого сервиса логотип его технологии, у баз — логотип базы.
  • Базы и сервисы из Docker-образа получают логотип по имени образа: PostgreSQL, MySQL, Redis, MongoDB, ClickHouse, n8n, Grafana…
  • Свою иконку можно выбрать в «Настройки → Сервис». Вариант «Авто» возвращает логотип технологии.
  • Для разработчиков: поле stack в объекте сервиса API, например {"framework": "laravel", "language": "php", "version": "8.3"}.

Из терминала#

Из папки — hangar up#

CLI упакует папку (без .git и файлов из .gitignore / .hangarignore), загрузит её и соберёт: по Dockerfile, если он есть, иначе Railpack сам определит язык (Node, Python, Go, PHP, Ruby, Java, Rust, статика…). Логи сборки и запуска идут прямо в терминал.

Терминал
hangar up             # собрать и задеплоить
hangar up -d          # не ждать, логи потом: hangar logs --build
hangar up --path ./backend

Приложение должно слушать порт из переменной PORT (по умолчанию 8080). Публичный адрес: hangar domain add, затем hangar open.

Из GitHub или Docker-образа#

Терминал
hangar github repos
hangar service create api --repo acme/api --branch main
hangar service create cache --image redis:7
hangar deploy                     # из настроенного источника
hangar deploy --commit 1a2b3c4

При подключённом GitHub каждый push в ветку деплоится сам.

История, откат, остановка#

Терминал
hangar deployments          # последние 10
hangar rollback             # вернуть предыдущий деплой целиком
hangar rollback 01a1…       # конкретный
hangar redeploy             # тот же образ, но с новыми переменными
hangar cancel               # прервать идущую сборку
hangar down -y              # остановить; вернуть — hangar redeploy

Docker Compose: весь проект сразу#

Если в репозитории несколько частей (API, фронтенд, админка, базы), которые запускаются через docker-compose, разверните их одним действием: «Добавить сервис → Docker Compose». Hangar сам предложит это, когда вы выберете такой репозиторий, а если сборка из корня упала, подскажет в логах. Сначала он покажет план, ничего не создавая, и вы сможете выключить лишние сервисы, включить или выключить публичные домены и поменять переменные.

  • Файл: docker-compose.prod.yml, если он есть (поверх docker-compose.yml, если это только переопределения), иначе docker-compose.yml или compose.yaml. Hangar ищет в корне, а также в deploy/ и docker/.
  • Сервисы с build: собираются из своей папки (context) с указанным Dockerfile.
  • Базы (Postgres, MySQL, MariaDB, MongoDB, Redis, RabbitMQ, ClickHouse, Elasticsearch, MinIO и другие) поднимаются с постоянным диском и ежедневным бэкапом.
  • Связи: db:5432, redis://redis:6379, http://api:8000 превращаются в адреса сервисов внутри проекта, а http://localhost:<порт> другого сервиса — в его публичный HTTPS-адрес.
  • ${VAR} из compose становятся общими переменными окружения. Значения берутся из .env.example, пароли и ключи генерируются, недостающие Hangar попросит ввести.
  • Сервисы с ports: получают публичный домен. nginx, traefik, caddy и certbot не нужны: маршрутизацию и HTTPS Hangar делает сам.
  • Базы деплоятся первыми, затем собираются приложения.
HTTP / JSON
POST https://api.hangar.rest/v1/projects/<project>/compose/plan     {"repo": "owner/repo", "branch": "main"}
POST https://api.hangar.rest/v1/projects/<project>/compose/deploy   {"repo": "owner/repo", "services": ["server", "app", "db"], "shared": {"STRIPE_KEY": "…"}}