Skip to content

Self-hosted homelab infrastructure visualizer — interactive network diagram with live status monitoring

docs: document ACCESS_TOKEN_EXPIRE_MINUTES (#566)

Pouzor - Rémy Jardient204bb077fc3b
diff --git a/.env.example b/.env.example
index fc24fb7..0631d91 100644
--- a/.env.example
+++ b/.env.example
@@ -23,6 +23,9 @@ AUTH_MODE=local
# backend unwraps one matched pair itself — quoted or not, both work everywhere.
AUTH_USERNAME=admin
AUTH_PASSWORD_HASH='$2b$12$RtMbyw17l4N5UGzeXMNAWuzCaVV.XFBY7ZetWheQhxcBDcxahapkG'
+# Local session lifetime in minutes (default 1440 = 24 h). Closing the tab or the
+# browser still ends the session. For an always-on wall screen, prefer LIVEVIEW_KEY.
+# ACCESS_TOKEN_EXPIRE_MINUTES=1440
# OpenID Connect (optional alternative to local auth).
# Set AUTH_MODE=oidc and configure every value below. The callback must be
diff --git a/README.md b/README.md
index 1258e0d..a125062 100644
--- a/README.md
+++ b/README.md
@@ -309,6 +309,18 @@ Each host is linked to its guests with a `virtual` edge. vCPU / RAM / disk are i
---
+## Session duration
+
+With local auth, a login lasts 24 hours. Change it in your `.env` (value in minutes), then restart the backend:
+
+```env
+ACCESS_TOKEN_EXPIRE_MINUTES=10080 # 1 week
+```
+
+The session is kept per tab: closing the tab or the browser always asks for a new login. To keep the canvas on a screen permanently, use [Live View](#live-view-read-only-public-canvas) instead — it needs no login at all. OIDC sessions use `OIDC_SESSION_EXPIRE_MINUTES` (max 1440).
+
+---
+
## Live View (read-only public canvas)
Live View lets you share a read-only snapshot of your canvas with anyone on your network — no login required. It is disabled by default.