Konfiguration

~/.aihummer/etc/gateway.env

# ~/.aihummer/etc/gateway.env (excerpt)
AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer
AIHUMMER_MASTER_KEY=base64-32-bytes...
AIHUMMER_GATEWAY_ADDR=:8780
AIHUMMER_WEBUI_ADDR=:8781
AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main

systemctl restart aihummer-gateway

# Wire a real model (unset → deterministic mock)
aihummer settings set AIHUMMER_LLM_PROVIDER openai
aihummer settings set AIHUMMER_LLM_MODEL gpt-4o-mini
aihummer settings set AIHUMMER_LLM_GATEWAY_URL https://api.openai.com/v1

# Enable tools by pointing at their backends

# Voice sidecars (STT/TTS auto-configured by the installer)
aihummer settings set AIHUMMER_STT_URL http://localhost:8001
aihummer settings set AIHUMMER_TTS_URL http://localhost:8002

# Real vector store + embedder (example URLs; the embedder is installed with
# --with-embedder, otherwise memory uses the lexical fallback)
aihummer settings set AIHUMMER_QDRANT_URL http://localhost:6333
aihummer settings set AIHUMMER_EMBEDDER_URL http://localhost:8080

AiHummer konfigureres gennem en **indstillingsoversigt**, ikke en bunke miljøvariabler. `gateway.env` er **kun bootstrap**: databases DSN, lytteadresser/porte, hovednøglen og lignende. Hver anden nøgle findes i databasen og ændres fra webadministratorgrænsefladen under kørslen eller med `aihummer settings` CLI. Den vejledende regel er simpel: **alt, der kan indstilles, kan konfigureres i Web UI** — ikke kun env, og ikke hardkodet. ## Løsningsrækkefølge Hver katalogindstilling løses på samme måde, først match vinder: 1. **Database** — en værdi indstillet via admin-brugergrænsefladen eller `aihummer settings set`. 2. **Standard** — den indbyggede standard, der følger med udgivelsen. Miljøet er **med vilje ikke en del af denne kæde**: for katalognøgler en `AIHUMMER_*` variabel i `gateway.env` er **ignoreret**, selvom det er indstillet. Det giver hver indstilling præcis én sandhedskilde — databasen — så en UI-værdi aldrig kan blive tyst overskygget af en glemt linje i en miljøfil. > [!NOTE] > For at ændre adfærd i produktionen redigerer du ikke konfigurationsfiler — du ændrer > indstilling i admin-UI'en (**Administration → Indstillinger**, en søgbar side) eller kør > `aihummer settings set <KEY> <VALUE>` (`get` / `list` at læse), og det tager > effekt for det pågældende arbejdsområde. Installatøren selv påfører de indledende katalogværdier > ind i databasen via `aihummer settings set`. ## Hot vs genstart-påkrævet Hvordan en ændret indstilling træder i kraft afhænger af tasten: | Adfærd | Eksempler | Når det gælder | |---|---|---| | **Hot** | værktøjsaktivering, underagent maks dybde | Læses igen under kørsel, ingen genstart | | **Genstart kræves** | lytteadresse, kabling af visse tjenester | Anvendt ved næste gateway-genstart | Genvejstaster læses live igen, så skift af et værktøj eller justering `subagent-depth` træder i kraft på næste tur. Nogle strukturelle nøgler træder kun i kraft efter en genstart; admin-brugergrænsefladen markerer, hvilke det er. ## Bootstrap-variabler forbliver kun i miljøet Nogle få variabler skal være til stede i miljøet, fordi de er nødvendige, før indstillingskataloget (og den database, det læser fra) eksisterer. Disse **bootstrap** variabler er kun til miljøet og vises ikke i administrations-brugerfladen: | Variabel | Hvorfor det er bootstrap | |---|---| | `AIHUMMER_DATABASE_URL` | Databasen skal eksistere, før nogen databaseunderstøttet indstilling kan læses. | | `AIHUMMER_DB_APP_URL` | Begrænset rolle DSN, der aktiverer RLS. | | `AIHUMMER_MASTER_KEY` | base64-32 byte; låser op for hemmeligheder-i-ro / hvelv / BYOK. | | `AIHUMMER_GATEWAY_ADDR` | Offentlig lytteadresse (standard `:8780`) — API, parring, WS/SSE, indgående og app/pocket-proxy. | | `AIHUMMER_WEBUI_ADDR` | Privat admin Web UI lytteadresse (standard `:8781`), serveret ved rod `/`; sat til `0` at deaktivere. | | `AIHUMMER_BLOB_DIR` | Filsystemsti til blob/media-mappen — nødvendigt ved opstart. | | `AIHUMMER_OIDC_ISSUER` | Beskytter `/v1/admin/*` før UI'en er tillid til. | Ops wiring såsom telemetry OTLP-endpointet falder ind under samme bootstrap-kategori. Alt, der ikke er på denne korte liste, er en katalognøgle: det lever i databasen, og env ignoreres for det. > [!WARNING] > Behold `AIHUMMER_MASTER_KEY` sikker og sikkerhedskopieret **separat** fra din database > backup. Den dekrypterer legitimationslageret; mister du det, mister du de krypterede hemmeligheder > kan ikke gendannes. ## Konfigurationsfilen For værts-native installationer befinder bootstrap-miljøet sig i en enkelt fil, som systemd-enheden indlæser: ```text ~/.aihummer/etc/gateway.env ``` Rediger denne fil **kun for bootstrap-værdier**, genstart derefter gateway-tjenesten for at anvende ændringerne: ```ini # ~/.aihummer/etc/gateway.env (excerpt) AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer AIHUMMER_MASTER_KEY=base64-32-bytes... AIHUMMER_GATEWAY_ADDR=:8780 AIHUMMER_WEBUI_ADDR=:8781 AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main ``` ```bash systemctl restart aihummer-gateway ``` Alt ud over disse bootstrap-nøgler — agenter, værktøjer, hukommelsestilstand, ræsonnementsstrategier, budgetter, sikkerhedsforanstaltninger og resten — styres fra admin UI's indstillinger (eller via `aihummer settings`), ikke fra denne fil: env ignoreres for disse nøgler. ## Ledningsføring af valgfrie funktioner Mange funktioner er slukket, indtil du peger dem på en backing-service. Alle disse nøgler er katalogindstillinger (de ligger i databasen): indstil dem i admin-UI'en (**Administration → Indstillinger**) eller med CLI; ved at sætte dem i `gateway.env` gør ingenting — env ignoreres for dem. For sidecars installeret fra bundtet (STT/TTS osv.) indsætter installatøren værdierne i databasen selv. ```bash # Wire a real model (unset → deterministic mock) aihummer settings set AIHUMMER_LLM_PROVIDER openai aihummer settings set AIHUMMER_LLM_MODEL gpt-4o-mini aihummer settings set AIHUMMER_LLM_GATEWAY_URL https://api.openai.com/v1 # Enable tools by pointing at their backends # Voice sidecars (STT/TTS auto-configured by the installer) aihummer settings set AIHUMMER_STT_URL http://localhost:8001 aihummer settings set AIHUMMER_TTS_URL http://localhost:8002 # Real vector store + embedder (example URLs; the embedder is installed with # --with-embedder, otherwise memory uses the lexical fallback) aihummer settings set AIHUMMER_QDRANT_URL http://localhost:6333 aihummer settings set AIHUMMER_EMBEDDER_URL http://localhost:8080 ``` > [!TIP] > En rigtig model er aldrig påkrævet. Uden `AIHUMMER_LLM_*` tilsluttet, svar kommer > fra en deterministisk mock; AiHummer kører også på gratis/lokal OpenAI-kompatibel > endpoints og en Codex/ChatGPT-abonnementsforbindelse, med valgfri BYOK. ## Notifikationer Administratorbrugergrænsefladerne **Notifikationer** siden (under "Kontrol") er instansens indbakke for begivenheder (administrator login, opdatering tilgængelig/anvendt, sidecar går ned eller genopretter, og så videre) med filtre efter kategori, alvor og ulæste. Ved siden af den sidder en **kategori × distributionskanal matrix**: for hver begivenhedskategori du aktiverer **webbrugergrænseflade**, **email**, **telegram** og **skub** kanaler. Webbrugerfladenotifikationer leveres lokalt; Telegram er forbundet med knappen "Link Telegram" (dyb link), e-mail aktiveres, når supportadressen er bekræftet, og push-meddelelser kommer i mobilappen. Kritiske hændelser kan ikke dæmpes på webbrugerfladekanalen. ## Hvor til næste - Lås administratortilmeldingen: [Første login](/da/v1.0/getting-started/first-login). - Se hvor filer ligger: [Installation](/da/v1.0/getting-started/installation). - Tjek forudsætningerne: [Krav](/da/v1.0/getting-started/requirements).