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

35 lines
1.7 KiB
Markdown

# 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 перенаправления».
0. **Нужен первый пользователь**: в базе было 0 пользователей, а регистрация
была закрыта — OIDC-вход не мог создать учётку. Открыли регистрацию
(`HBOX_OPTIONS_ALLOW_REGISTRATION=true`); после создания владельца
регистрацию надо снова закрыть.
1. Без `HBOX_AUTH_API_KEY_PEPPER` (32+ байт) контейнер падает с panic.
2. OIDC-callback — `/api/v1/users/login/oidc/callback`.
3. Pepper хранится в `/root/.homebox-pepper`; менять нельзя — сломает API-ключи.