Files
buryan-infra/ops/services/cards/homebox.md
T

1.7 KiB

homebox

Параметр Значение
Группа Дом
Критичность normal
CT 110 (lifestyle-lxc)
Образ ghcr.io/sysadminsmedia/homebox:latest
Порт 9287
Домен homebox.buryans.ru — нужна DNS-запись
SSO OIDC через Authentik (провайдер Homebox)
Бэкап /opt/lifestyle-lxc/homebox/data → ct/homebox.tgz
Если упадёт Пропадёт инвентарь вещей и гарантий

Доступ

  • LAN: http://192.168.1.110:9287 → «Войти через OIDC»
  • Публично: после A-записи homebox.buryans.ru → 193.233.210.184

Ловушки

-1. Homebox формирует redirect_uri со схемой http, даже когда доступ идёт по https (прокси не влияет). Поэтому в провайдере Authentik зарегистрированы оба варианта: http:// и https://. Иначе — «Ошибка URI перенаправления».

  1. Нужен первый пользователь: в базе было 0 пользователей, а регистрация была закрыта — OIDC-вход не мог создать учётку. Открыли регистрацию (HBOX_OPTIONS_ALLOW_REGISTRATION=true); после создания владельца регистрацию надо снова закрыть.

  2. Без HBOX_AUTH_API_KEY_PEPPER (32+ байт) контейнер падает с panic.

  3. OIDC-callback — /api/v1/users/login/oidc/callback.

  4. Pepper хранится в /root/.homebox-pepper; менять нельзя — сломает API-ключи.