Если что-то сломалось

С чего начать

hooba status

Покажет, какие контейнеры работают, отвечает ли сервер, сколько осталось сертификату и места на диске. Во многих случаях достаточно:

hooba repair

Это пересоздаёт все контейнеры. Данные не трогаются — база, картинки и настройки остаются.

Если не помогло — смотрите журнал:

hooba logs backend    # сервер
hooba logs web        # сайт (nginx)
hooba logs coturn     # голос (TURN)
hooba logs postgres   # база

Выход из журнала — Ctrl+C.

Сайт не открывается

Что видно	Что проверить
Браузер долго грузит и пишет «время ожидания истекло»	Порт 443 закрыт в брандмауэре хостинга или сервер выключен. Проверьте панель хостинга и порты
«Подключение не защищено», сертификат истёк	Продление сертификата
502 Bad Gateway	Сайт работает, а сервер за ним — нет. hooba status, затем hooba repair. Если повторяется — hooba logs backend
Открывается чужой сайт или заглушка хостинга	A-запись домена указывает не на тот IP

Нет голоса или демонстрации экрана

Чат работает, а в голосовом канале не слышно друг друга или подключение висит.

1. Порты. Почти всегда причина — закрытые UDP-порты в брандмауэре хостинга: 3478, 40000–40100, 50000–50100. См. Порты и брандмауэр.
2. Контейнер голоса. В hooba status должен работать coturn. Если нет — hooba repair, затем hooba logs coturn.
3. Сменился IP сервера (например, после переезда). Запустите hooba install — он перепишет адрес для голоса.
4. Не работает только у одного участника — скорее всего, его сеть или браузер: пусть разрешит сайту доступ к микрофону и попробует другой браузер или мобильный интернет.

Демонстрация экрана на телефоне

Мобильные браузеры, как правило, не дают сайтам показывать экран: смотреть чужую демонстрацию с телефона можно, транслировать свою — с компьютера.

«Порт занят»

Во время установки: Порт 80 занят программой ….

• Если это nginx, apache2, caddy или turnserver, установленные в системе, скрипт сам предложит их остановить.
• Если docker-proxy — порт держит другой Docker-контейнер. Посмотрите docker ps и остановите лишний: docker stop <имя>.
• Иначе — остановите программу, которую назвал скрипт, и запустите установку снова.

Не хватает памяти или места

• Сборка падает с Killed, exit code 137 или JavaScript heap out of memory — не хватило памяти. Включите swap: запустите hooba install снова — на сервере меньше 2 ГБ он предложит создать swap-файл. Или возьмите тариф с 2 ГБ+.
• no space left on device — кончился диск. См. Место под картинки.

Сервер не поднимается после перезагрузки VPS

Hooba запускается сам при старте системы. Если после перезагрузки сайт не открылся:

hooba start

Ничего не помогло

1. Сделайте копию на всякий случай: hooba backup.
2. Попробуйте откатить последнее обновление, если проблема началась после него.
3. Соберите журналы для вопроса: файл /opt/hooba/logs/<команда>.log той команды, что упала, и вывод hooba logs backend за время ошибки.

Не публикуйте .env.prod

Отправляя журналы, проверьте, что в них нет содержимого .env.prod — там пароли сервера.