Miljøvariabler

AiHummer-konfiguration opdeles i to strengt forskellige grupper:

Bootstrap (gateway.env) — hvad porten skal vide før det kan læs databasen: database DSN, lytteadresser, statiske mapper, hovednøglen. Kun disse nøgler læses fra miljøet.
Indstillingskatalog (database) — hver anden knap. Disse opbevares i database og indstil i webadmin-brugerfladen (Administration → Indstillinger) eller med aihummer settings set <KEY> <VALUE>. For disse taster a gateway.env værdi er med vilje ignoreret — selvom det er indstillet, har det ingen effekt.

Konfigurationsmodel

gateway.env er kun bootstrap. Beslutningsrækkefølge:

Indstillingskatalognøgle: database value → built-in default (miljøet ignoreres);
bootstrap-nøgle: environment variable only.

Så den eneste kilde til sandheden for justerbare knapper er databasen (webadmin UI / aihummer settings); miljøet bærer kun det, processen har brug for at starte.

Konfigurationsfilen til en host-native installation ligger på:

# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes

[!TIP] Sæt ikke Settings-katalogknapper i gateway.env — det har ingen effekt. Skift dem i webadmin-brugerfladen (Administration → Indstillinger, den har søgefunktion) eller via aihummer settings set. Nogle ændringer (såsom værktøjsskift og underagent dybde) anvend varm; andre kræver en genstart af tjenesten.

Bootstrap (gateway.env)

De eneste nøgler, som gatewayen faktisk læser fra miljøet.

Kerne & database

Variabel	Formål
`AIHUMMER_DATABASE_URL`	Påkrævet. Postgres DSN. Uden det kører gatewayen kun i sundheds-tilstand.
`AIHUMMER_DB_APP_URL`	Begrænset-rolle DSN, der aktiverer række-niveau sikkerhed (indstilles automatisk for lokale installationer).
`AIHUMMER_GATEWAY_ADDR`	Offentlig lytteadresse (standard `:8780`) — al ekstern trafik: API (`/v1/*`), parring, WS/SSE, indgående webhooks, app/pocket-proxyen og sundhedsprober.
`AIHUMMER_WEBUI_ADDR`	Privat admin Web UI lytteadresse (standard `:8781`), serveret ved roden af stien `/`; ideelt set bundet til en intern-only grænseflade. Indstillet til `0` at deaktivere.
`AIHUMMER_DEFAULT_WORKSPACE_ID`	Vælger standardarbejdsområdet for konfigurerede indgående integrationer.
`AIHUMMER_HOME_ROOT`	Installer rod (normalt afledt af binærstien); forankrer admin-ui/blob/installer-mapperne og nøglefilerne.
`AIHUMMER_BLOB_DIR`	Aktiverer medie-/filtjenesten (blob-lagringsmappe). Det gemmer også private (side-indlæste) plugin-artefakter under `blob:` refs som deployeren løser.
`AIHUMMER_ADMIN_UI_DIR`	Serverer admin SPA på `/admin/`.

Hemmeligholdelser og infrastruktur

Variabel	Formål
`AIHUMMER_MASTER_KEY`	base64-kodede 32 bytes; muliggør hemmeligheder i hvile, hvælvet og BYOK.
`AIHUMMER_MEDIA_TOKEN_SECRET`	Holder underskrevne download-URL’er gyldige på tværs af genstarter.
`AIHUMMER_OTEL_ENDPOINT`	OTLP-endpoint til push af spor/metrikker.
`AIHUMMER_DOWNLOAD_BASE_URL`	Base-URL for udgivelsesartefakter (selvopdateringskilde).

[!WARNING] Observabilitet er Kun OTLP push. AiHummer gør ikke afsløre en Prometheus /metrics endepunkt eller /debug/pprof. Punkt AIHUMMER_OTEL_ENDPOINT hos dig indsamler i stedet.

Indstillingskatalog (database — webadministrationsgrænseflade eller `aihummer settings`)

Hver tast nedenfor findes i databasen. Indstil den i webadmin-brugergrænsefladen (Administration → Indstillinger) eller sådan her:

aihummer settings set AIHUMMER_LLM_PROVIDER openai

A gateway.env værdien for en sådan nøgle er ignoreret.

Sikkerhed

Nøgle	Formål
`AIHUMMER_APPROVAL_TOOLS`	Værktøjer, der kræver menneskelig godkendelse, før de kører.
`AIHUMMER_AIRGAPPED`	`1` blokerer modelstyret offentlig udgang (luftafskåret tilstand).
`AIHUMMER_AUDIT_RETENTION_DAYS`	Opbevaringsperiode for admin-revisionsloggen.
`AIHUMMER_INBOUND_SECRET`	HMAC delt hemmelighed for connector → gateway `/v1/inbound/*` opkald.

Autentificering og SSO

Nøgle	Formål
`AIHUMMER_OIDC_ISSUER`	Beskytter `/v1/admin/*`. Uden det (og uden LDAP/SAML) stoler admin på dev-headere — udsæt aldrig en sådan instans.

LDAP/AD og SAML er konfigureret sammen med OIDC til virksomhedssignering; SCIM leverer automatisk brugerprovisionering. Se Webhooks, SCIM og parring.

LLM & modeller

Nøgle	Formål
`AIHUMMER_LLM_PROVIDER`	Modeludbyder, der skal bruges.
`AIHUMMER_LLM_MODEL`	Modelnavn.
`AIHUMMER_LLM_GATEWAY_URL`	Grund-URL for en OpenAI-kompatibel LLM-gateway/endpoint (den `AIHUMMER_LLM_*` sti; adskilt fra den oprindelige `AIHUMMER_OPENAI_BASE_URL`). Se BYOK & udbydere.
`AIHUMMER_OPENAI_API_KEY`	API-nøgle til en OpenAI-kompatibel udbyder.
`AIHUMMER_SUBAGENT_MAX_DEPTH`	Maksimal dybde af genererede underagenter.

[!NOTE] Hvis ingen model er tilsluttet, falder gatewayen tilbage til en deterministisk mock så den systemet kører stadig. Ingen betalt model-API er nogensinde nødvendig — gratis/lokale modeller og en Codex/ChatGPT-abonnementstransport er førsteklasses.

Værktøjer

Nøgle	Formål
`AIHUMMER_FS_ROOT`	Muliggør `filesystem_read`, isoleret under denne rod.
`AIHUMMER_DB_QUERY_DSN`	Muliggør `db_query` (skrivebeskyttet) mod dette DSN.
`AIHUMMER_CODE_EXEC`	Skifter `code_exec` værktøj (som standard slået fra på delte værter).

Websøgning og browseren administreres af installationsprogrammet: de installeres direkte fra start, slås fra med --no-search / --no-browser og peges på en eksisterende instans med --external-search=URL / --external-browser=URL — der findes ingen operatørindstillinger for dem.

Se hele Værktøjskatalog hvad hvert værktøj gør.

Stemme og sidevogne

Nøgle	Formål
`AIHUMMER_STT_URL`	Tale-til-tekst sidecar-URL (seedet af installatøren).
`AIHUMMER_TTS_URL`	Tekst-til-tale sidecar-URL (seedet af installatøren).
`AIHUMMER_VIDEO_URL`	Video-forståelse sidevogn URL.

Sidecars er separate HTTP-tjenester; gatewayen når dem via URL.

Vektorer & indlejring

Nøgle	Formål
`AIHUMMER_QDRANT_URL`	Rigtig vektorbutik (Qdrant). Fraværende → hukommelseslager.
`AIHUMMER_EMBEDDER_URL`	Ægte indlejringsservice. Fraværende → hash-indlejer.

Protokolflader (valgfrit)

Nøgle	Formål
`AIHUMMER_MCP_PUBLISH`	Præcis `1` åbner den eksterne MCP-server på `POST /v1/mcp`. Alene eksporterer den ingen værktøjer.
`AIHUMMER_MCP_EXPORT_TOOLS`	Kommaadskilte præcise værktøjsnavne, som MCP-klienten ser. Tom (standard) = NUL værktøjer eksporteres.
`AIHUMMER_A2A_PUBLISH`	`1` muliggør A2A-overfladen (`/.well-known/agent.json`, `/a2a/message`).

Kun udviklerbygninger

Variabel	Formål
`AIHUMMER_PLUGIN_PUBKEY`	En ekstra pålidelig offentlig nøgle (base64 ed25519) til at verificere pluginsignaturer. Kun til udviklingsbygninger — ignoreres i udgivelsesbygninger (registreringsdatabasenøglen er fastgjort i binærfilen).
`AIHUMMER_PLUGIN_DEV_UNSIGNED`	`1` tillader installation usigneret plugins. Kun til udvikling — ignoreres i udgivelsesbygninger. Aldrig på en eksternt tilgængelig instans.

[!WARNING] I udgivelsesbygninger er plugin-tillidsrod indbygget i binærfilen og kan ikke overskrives af miljøet eller indstillinger — dette er en anti-manipulation garanti.

Tillidsmodellen (officiel → fast nøgle, privat → tillidslager, usigneret → blokeret) er beskrevet i Installation og opdateringer.

Hvor til næste

Se, hvilke værktøjer hver nøgle låser op for: Værktøjskatalog.
Betjen instansen dagligt: CLI-reference.