CLI-reference

sudo aihummer up
aihummer status

# Only check whether a newer release exists
aihummer update --check

# Apply the update
sudo aihummer update

sudo aihummer restart
aihummer logs                 # the gateway unit's journal (default; follows)
aihummer logs --no-follow     # print the tail of the journal and exit
aihummer logs aihummer-stt    # another systemd unit's journal
sudo aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql

sudo aihummer set-password --login admin

aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings get AIHUMMER_STT_URL
aihummer settings list

aihummer license keygen                # generate a signing key
aihummer license sign                  # sign a license
aihummer license show <token>          # decode + verify a token

aihummer loadtest

aihummer plugin init <kind>            # scaffold a manifest (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # validate a manifest against the contract
aihummer plugin keygen                 # ed25519 author key (.key + .pub)
aihummer plugin package ./my-plugin    # build a tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Publish privately to your instance (public publishing is done in the portal — "My plugins")
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz

Den `aihummer` Kommandolinjeværktøj håndterer en vært-native installation: det starter og opdaterer gatewayen (selve installationen udføres via det personlige installationslink fra din kontoportal), styrer gateway systemd-tjenesten, kører diagnostik, håndterer sikkerhedskopier, læser og skriver kontrolplanindstillinger og underskriver licenser. Denne side viser alle kommandoer. ## Kommandoer | Kommando | Hvad det gør | |---|---| | `up` / `install` | Start gateway-systemd-tjenesten (`systemctl start`). Det installerer ingenting — installationen udføres af installationsscriptet fra dit personlige link. | | `update [--check]` | Opdater til den nyeste version (verificer signatur + udskift binærfil + genstart); `--check` rapporterer kun, om en opdatering er tilgængelig. | | `restart` | Genstart gateway-tjenesten (`systemctl restart`). | | `stop` | Stop gateway-tjenesten (`systemctl stop`). | | `logs [unit] [--no-follow]` | Følg journalen for en systemd-enhed (`journalctl -u`); standardindstilling er gateway-enheden. `--no-follow` udskriver slutningen af journalen og afslutter; uden flaget bliver kommandoen ved med at følge. | | `status` | Overblik over installationen, tjenesternes tilstand og gatewayens parathed (`/readyz`). En **Komponenter**-sektion rapporterer tilstanden af de valgfrie sidecar-enheder (søgning, browser, tale-til-tekst, tekst-til-tale, video); når `systemctl` ikke er tilgængelig, siger den ærligt, at tilstanden er ukendt, i stedet for "ikke installeret". | | `doctor` | Diagnostik med tre domme: alt i orden, kører med advarsler (N), eller problemer fundet. Kontrollerne for Node.js og registreringsmateriale er advarsler, ikke fejl. | | `backup [dir]` | `pg_dump` PostgreSQL-statsplanet til en fil; en standardmappe bruges, hvis den udelades. | | `restore <file>` | Gendan PostgreSQL fra en dump-fil produceret af `backup`. | | `uninstall [flags]` | Fjern installationen (se flag nedenfor). Kræver root — kør det med `sudo`. | | `set-password` / `admin-password` | Indstil/generer den lokale administratoradgangskode (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | Læs/skriv kontrolplansindstillinger i databasen — sådan konfigureres indstillinger i indstillingskataloget fra CLI i stedet for `gateway.env`. | | `license {keygen\|sign\|show <token>}` | Administrer licenser: generer en nøgle, signer, dekod + verificer en given token. | | `loadtest` | Kør en belastningstest mod gatewayen. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Plugin SDK: opbygge, validere, nøgler, pakke, signere og udgive. | | `version` | Print versionen. | | `help` | Vis hjælp. | ### `uninstall` flag | Flag | Effekt | |---|---| | `--purge` | Fjern også data (fuldstændig fjernelse). | | `--yes` | Spring bekræftelsesprompten over. | | `--no-backup` | Tag ikke en sikkerhedskopi, før du fjerner. | | `--backup-dir <dir>` | Skriv backupen før afinstallation til dette bibliotek. | ## Brugseksempler ### Installer og bring op Installationen udføres via det personlige installationslink fra din kontoportal (se [Installation](/da/v1.0/getting-started/installation)); derefter starter CLI'en og tjekker tjenesten: ```bash sudo aihummer up aihummer status ``` ### Opdatering ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### Servicekontrol og logfiler Kommandoerne virker på den enkelte gateway systemd-enhed (`AIHUMMER_SERVICE`, standard `aihummer-gateway`); `logs` accepterer ethvert systemd-enhedsnavn. ```bash sudo aihummer restart aihummer logs # the gateway unit's journal (default; follows) aihummer logs --no-follow # print the tail of the journal and exit aihummer logs aihummer-stt # another systemd unit's journal sudo aihummer stop ``` ### Diagnostik ```bash aihummer doctor ``` ### Backup og gendannelse `backup` driver en `pg_dump` af PostgreSQL-tilstandsplanet til en fil; `restore` tager den dumpfil. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres er sandhedskilden, men din `AIHUMMER_MASTER_KEY` og blobben > mappen skal sikkerhedskopieres separat — uden hovednøglen, krypteret > hemmeligheder kan ikke gendannes. ### Indstil admin-adgangskoden Kommandoen accepterer `[--login admin] [--password X]` og behov `AIHUMMER_DATABASE_URL` — normalt opsamlet fra `gateway.env` når den køres som installationsbruger eller via `sudo`. ```bash sudo aihummer set-password --login admin ``` ### Kontrolplanindstillinger `settings` læser og skriver Settings-katalogkontakter direkte i databasen — den samme butik, som webadministrationsbrugergrænsefladen (Management → Settings) redigerer. Dette er, hvordan katalogkontakter konfigureres fra CLI: `gateway.env` værdier ignoreres for dem. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` viser kun de brugerrettede katalognøgler (system- og interne nøgler er skjult); hver nøgle er mærket med sin kilde — `[db]` for de værdier, du indstiller, `[unset]` med katalogets standard ellers. ### Licenser `license show` kræver en `<token>` argument og den `AIHUMMER_LICENSE_PUBKEY` variabel: den dekoder og verificerer **givet** token — den viser ikke instansens nuværende licens. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### Belastningstest ```bash aihummer loadtest ``` ### Plugins ```bash aihummer plugin init <kind> # scaffold a manifest (connector|service|openapi|mcp) aihummer plugin validate manifest.json # validate a manifest against the contract aihummer plugin keygen # ed25519 author key (.key + .pub) aihummer plugin package ./my-plugin # build a tarball + .sha256 aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz # Publish privately to your instance (public publishing is done in the portal — "My plugins") aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz ``` For den fulde SDK, og for at udgive til den delte katalog fra portalen («Mine plugins»), se [Plugin SDK](/da/v1.0/marketplace/sdk) og [Publicering af en plugin](/da/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` kræver root: kør `sudo aihummer uninstall`. Og > `sudo aihummer uninstall --purge --yes` fjerner data og springer over > bekræftelsesprompt — sørg for, at du først har en verificeret sikkerhedskopi. ## Miljø Variablerne `aihummer` værktøjet selv læser: | Variabel | Formål | |---|---| | `AIHUMMER_SERVICE` | Gateway-systemd-enhedsnavnet (standard `aihummer-gateway`) — målet for `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | Gateway-URL for `status`/`doctor`/`loadtest` (standard `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — påkrævet af `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | Sprog for CLI-output og hjælp: `ru` (standard) eller `en`. | De fleste kommandoer kræver root (`systemctl`) — kør dem med `sudo`. ## Hvor til næste - Konfigurer instansen: [Miljøvariabler](/da/v1.0/reference/env-vars). - Beslut hvilke værktøjer agenten kan bruge: [Værktøjskatalog](/da/v1.0/reference/tools-catalog).