В панели#
- Добавить
Сервис → «Переменные» → «Переменная»: имя и значение. Значение-секрет скрыто точками, глаз показывает его.
- Ссылки
Кнопка «Ссылка на сервис» вставляет
${{ Сервис.ПЕРЕМЕННАЯ }}— например, адрес базы. Связи видны линиями на схеме. - Много сразу
«Редактор .env» — все переменные одним файлом: вставьте свой .env целиком, комментарии и порядок строк сохранятся. Вкладка «Общие» — переменные окружения для всех сервисов, «Итоговые» — что реально получит сервис.
- Применить
Изменения применяются при следующем деплое: «Деплой» в обзоре или
hangar redeploy.

Управление переменными#
Переменные задаются на сервис и окружение. Изменения применяются при следующем деплое (hangar redeploy).
hangar vars set NODE_ENV=production API_KEY=sk_live_… --seal
hangar vars set SENTRY_DSN=https://… --comment "куда шлём ошибки"
hangar vars list
hangar vars import .env.production
hangar vars import .env --replace # удалить те, которых нет в файле
hangar vars export -o .env # файл с комментариями, как был загружен
hangar vars resolved # что реально получит сервис
hangar vars delete OLD_KEYКомментарии в .env#
Файл .env загружается целиком, как есть. Hangar запоминает не только значения, но и сам документ: строки с #, пустые строки, порядок переменных, кавычки и комментарий после значения. «Редактор .env» в панели и hangar vars export возвращают тот же файл с текущими значениями.

# ===== База данных =====
# Основное подключение: API и воркер
DATABASE_URL=${{ Postgres.DATABASE_URL }}
DB_POOL=10 # соединений на реплику
# ===== Платежи =====
# Ключ меняем раз в год
STRIPE_KEY=<sealed>
#STRIPE_OLD_KEY=отключён- Комментарий над переменной виден в списке под её именем. Его можно править и без файла: «Изменить» → поле «Комментарий».
- Новая переменная, добавленная кнопкой, встаёт в конец файла. Удалённая уходит вместе со своим комментарием.
- Загрузка файла без «Удалить переменные, которых нет в списке» — частичная: комментарии остальных переменных остаются на месте.
- Запечатанные значения записаны как
NAME=<sealed>. Оставьте строку как есть — значение не изменится; файл можно скачать, поправить и загрузить обратно. - Строка-заголовок раздела (
# ===== Платежи =====) относится ко всей группе под ней: она не считается комментарием первой переменной и остаётся, пока в группе есть хоть одна. - Комментарии хранятся зашифрованными, как значения: в них часто оказываются старые ключи.
Ссылки между сервисами#
Значение может ссылаться на переменные других сервисов: ${{ Postgres.DATABASE_URL }}, своего сервиса: ${{ PORT }}, или общие переменные окружения (--shared). Сгенерированный домен сервиса — ${{ HANGAR_PUBLIC_DOMAIN }}, приватный адрес — ${{ HANGAR_PRIVATE_DOMAIN }}.
hangar vars set DATABASE_URL='${{ Postgres.DATABASE_URL }}'
hangar vars set --shared SENTRY_DSN=https://…Локальный запуск с переменными сервиса#
hangar run -- npm run migrate
hangar run -- python manage.py shell
hangar shell # новый shell с переменными
