Konfigurasjon

~/.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 er konfigurert gjennom en **innstillingskatalog**, ikke en haug med miljøvariabler. `gateway.env` er **bare bootstrap**: databases DSN, lytteadresser/porter, hovednøkkelen og lignende. Alle andre nøkler ligger i databasen og endres fra webadministrasjonsgrensesnittet under kjøring eller med `aihummer settings` CLI. Den ledende regelen er enkel: **alt som kan justeres er konfigurerbart i nettgrensesnittet** — ikke kun for miljøvariabler, og ikke hardkodet. ## Løsningsrekkefølge Hver kataloginnstilling løses på samme måte, først til mølla vinner: 1. **Database** — en verdi satt gjennom admin-UI eller `aihummer settings set`. 2. **Standard** — den innebygde standarden som følger med utgivelsen. Miljøet er **med vilje ikke en del av denne kjeden**: for katalognøkler en `AIHUMMER_*` variabel i `gateway.env` er **ignorert**, selv om det er satt. Det gir hver innstilling nøyaktig én sannhetskilde — databasen — slik at en UI-verdi aldri kan bli tyst overskygget av en glemt linje i en miljøfil. > [!NOTE] > For å endre atferd i produksjon redigerer du ikke konfigurasjonsfiler — du endrer > innstilling i administrasjonsgrensesnittet (**Administrasjon → Innstillinger**, en søkbar side) eller kjør > `aihummer settings set <KEY> <VALUE>` (`get` / `list` å lese), og det tar > effekt for det arbeidsområdet. Selve installasjonsprogrammet legger inn de første katalogverdiene > inn i databasen via `aihummer settings set`. ## Varme vs omstart nødvendig Hvordan en endret innstilling trer i kraft, avhenger av tasten: | Atferd | Eksempler | Når det gjelder | |---|---|---| | **Varm** | verktøyaktivering, maksimal dybde for underagent | Leses på nytt under kjøring, ingen omstart | | **Omstart kreves** | lytteadresse, kabling av enkelte tjenester | Gjelder ved neste omstart av gateway | Hurtigtaster leses på nytt live, så bytte av et verktøy eller justering `subagent-depth` trer i kraft på neste runde. Noen strukturelle nøkler trer kun i kraft etter en omstart; administrasjonsgrensesnittet markerer hvilken som er hvilken. ## Bootstrap-variabler forblir kun i miljøet Noen få variabler må være til stede i miljøet fordi de trengs før innstillingskatalogen (og databasen den leser fra) eksisterer. Disse **bootstrap** variabler er kun for miljøet og vises ikke i administrasjonsgrensesnittet: | Variabel | Hvorfor det er bootstrap | |---|---| | `AIHUMMER_DATABASE_URL` | Databasen må eksistere før noen databasebaserte innstillinger kan leses. | | `AIHUMMER_DB_APP_URL` | Begrenset rolle-DSN som aktiverer RLS. | | `AIHUMMER_MASTER_KEY` | base64-32 byte; låser opp hemmeligheter-i-ro / hvelv / BYOK. | | `AIHUMMER_GATEWAY_ADDR` | Offentlig lytteadresse (standard `:8780`) — API, tilkobling, WS/SSE, innkommende og app/pocket-proxyen. | | `AIHUMMER_WEBUI_ADDR` | Privat admin Web UI lytteadresse (standard `:8781`), servert ved roten `/`; satt til `0` å deaktivere. | | `AIHUMMER_BLOB_DIR` | Filsystembane til blob/media-katalogen — nødvendig ved oppstart. | | `AIHUMMER_OIDC_ISSUER` | Beskytter `/v1/admin/*` før brukergrensesnittet er pålitelig. | Ops-kabling som for eksempel telemetri-OTLP-endepunktet faller inn under samme bootstrap-kategori. Alt som ikke er på denne korte listen er en katalognøkkel: det lever i databasen, og env blir ignorert for det. > [!WARNING] > Beholde `AIHUMMER_MASTER_KEY` trygg og sikkerhetskopiert **separat** fra databasen din > backup. Den dekrypterer legitimasjonslageret; mister du det, går de krypterte hemmelighetene tapt > kan ikke gjenopprettes. ## Konfigurasjonsfilen For verts-native installasjoner, befinner bootstrap-miljøet seg i en enkelt fil som systemd-enheten laster: ```text ~/.aihummer/etc/gateway.env ``` Rediger denne filen **kun for bootstrap-verdier**, og start deretter gateway-tjenesten på nytt for å bruke endringene: ```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 utover disse bootstrap-nøklene — agenter, verktøy, minnemodus, resonnementstrategier, budsjetter, sikkerhetsmekanismer og resten — administreres fra administrasjonsgrensesnittets innstillinger (eller via `aihummer settings`), ikke fra denne filen: env blir ignorert for de nøklene. ## Kabling av valgfrie funksjoner Mange funksjoner er slått av til du peker dem mot en støttetjeneste. Alle disse nøklene er kataloginnstillinger (de ligger i databasen): sett dem i administrasjonsgrensesnittet (**Administrasjon → Innstillinger**) eller med CLI; legger dem i `gateway.env` gjør ingenting — env blir ignorert for dem. For sidecars installert fra pakken (STT/TTS osv.) fyller installasjonsprogrammet verdiene inn 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 ekte modell er aldri påkrevd. Uten `AIHUMMER_LLM_*` kablet, svar kommer > fra en deterministisk testdublikat; AiHummer kjører også på gratis/lokal OpenAI-kompatibel > endepunkter og en Codex/ChatGPT-abonnementstransport, med valgfri BYOK. ## Varsler Administratorgrensesnittet **Varsler** side (under "Control") er instansens innboks for hendelser (admin-innlogging, oppdatering tilgjengelig/anvendt, sidecar som går ned eller kommer tilbake, og så videre) med filtre etter kategori, alvorlighetsgrad og uleste. Ved siden av den sitter en **kategori × leveringskanal-matrise**: for hver hendelseskategori du aktiverer **nettgrensesnitt**, **e-post**, **telegram** og **dytte** kanaler. Web UI-varsler leveres lokalt; Telegram er koblet til med "Link Telegram"-knappen (dyplenke), e-post aktiveres når støtteadressen er bekreftet, og push-varsler mottas i mobilappen. Kritiske hendelser kan ikke dempes på webui-kanalen. ## Hvor til neste - Lås administrasjonsinnloggingen: [Første pålogging](/no/v1.0/getting-started/first-login). - Se hvor filer ligger: [Installasjon](/no/v1.0/getting-started/installation). - Sjekk forutsetningene: [Krav](/no/v1.0/getting-started/requirements).