AdventedHUD

Environment

• HUD_HOST

  Bind address

• HUD_PORT

  Listen port

• HUD_DB_PATH

  SQLite store

• HUD_DATA_DIR

  Root for OAuth credentials, Obsidian vault, DB

• HUD_LOG_LEVEL

  Log verbosity

• HUD_ALLOW_WRITES

  Enable file/DB writes (startup safety)

• HUD_SOUL_MD_PATH

  Onboarding soul file

• GOOGLE_TOKEN_FILEsecret

  Path to token JSON file

• HUD_ADMIN_API_KEYrequiredsecret

  X-HUD-Admin-Key header value (required)

• HUD_ALLOW_GOOGLE_WRITES

  Enable Google Calendar/Tasks projection

• HUD_RESOLVE_JWT_SUBJECT

  Set 1 to prefer JWT sub as user id

• GOOGLE_OAUTH_CREDENTIALSsecret

  Inline OAuth JSON string

• HUD_SOUL_MD_TEMPLATE_PATH

  Worksheet template for onboarding read (optional)

• GOOGLE_OAUTH_CREDENTIAL_IDsecret

  OAuth client ID

• GOOGLE_TOKEN_ENCRYPTION_KEYsecret

  Key for encrypting stored OAuth tokens

• GOOGLE_OAUTH_CREDENTIAL_FILEsecret

  Path to OAuth JSON file

• GOOGLE_OAUTH_CREDENTIAL_PATHsecret

  Dir to search for gOAuth*.json

• HUD_REQUIRE_POST_ONBOARDING_PUSH

  Set 0 to skip push-policy gate in dev