В панели#
- Источник
Сервис → «Настройки» → «Источник»: GitHub (репозиторий и ветка), Hangar Git или Docker-образ. Для GitHub и Hangar Git каждый push в ветку деплоится сам.
- Деплой вручную
В обзоре сервиса — кнопка «Деплой». Логи сборки открываются сразу и обновляются вживую.
- История и откат
Вкладка «Деплои»: все версии со статусом (Активный, Успешно, Заменён, Ошибка). У прошлой версии — «Откатить сюда»: запустится её образ с её конфигурацией и переменными.


Логотип технологии#
При каждой сборке 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 redeployDocker 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 делает сам.
- Базы деплоятся первыми, затем собираются приложения.
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": "…"}}
