Licensed to be used in conjunction with basebox, only.
// referenz
Versionsmatrix
Gilt für
Produkt: Server (Cloud zum Nachschlagen) · Zielgruppe: Platform Operator · Alle
Welche Helm-Chart-Version welche basebox-Version ausliefert, welche Komponenten gebündelt sind und mit welchen Infrastrukturversionen basebox geprüft wurde. In basebox Cloud hält basebox die Umgebung aktuell; die Matrix ist dort nur zum Nachschlagen relevant.
Aktuelles Release
| Version | |
|---|---|
Helm-Chart basebox.ai |
0.3.32 |
| basebox (App-Version) | 1.8.8 |
| Chart-Quelle | oci://gitea.basebox.health/basebox-distribution/helm/basebox.ai |
Die Chart-Version ist der Wert, den Sie bei helm upgrade --install … --version angeben; die App-Version ist das, was die Oberfläche unter „Über" zeigt. Installationsanleitung: Helm Charts verwenden.
Was das Umbrella-Chart bündelt
| Komponente | Rolle | Image / Quelle |
|---|---|---|
| frontend | Web-Oberfläche (Vue 3) | gitea.basebox.health/basebox-distribution/frontend |
| AISRV | Anwendungsserver, GraphQL/REST/OpenAI-kompatible API, MCP-Gateway | …/aisrv |
| storesrv | Speicherdienst (GraphQL) | …/storesrv |
| ragsrv | RAG-Vektordienst (PostgreSQL + pgvector) | …/ragsrv (gpu-latest / cpu-latest) |
| ragsrv-support | Modelldienst für Extraktion, OCR, Embeddings, STT | …/ragsrv-support |
| idp | Keycloak-Identitätsanbieter | …/idp |
| inference | Gebündelter LLM-Inferenzserver (vLLM) | …/inference |
| CloudNativePG-Operator | PostgreSQL-Cluster je Dienst | ghcr.io/cloudnative-pg/postgresql:16-standard-bookworm (Datenbank-Image) |
| MCP-Konnektoren | Optional, je Konnektor aktiviert | siehe MCP-Konnektoren mit Helm |
Die exakten Image-Tags eines installierten Releases lesen Sie aus dem Cluster:
kubectl -n basebox get deployments -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.spec.template.spec.containers[0].image}{"\n"}{end}'
Release-Historie
| basebox | Datum | Wesentliches | Chart-Version |
|---|---|---|---|
| 1.8.x | 2026-08-19 | Konnektoren (MCP), Websuche, Denkmodi, Quellen und Zitate, Audit-Viewer, organisationsweite Instruktionen, neues Design | 0.3.32 (aktuell) |
| 1.7.0 | 2026-04-25 | OpenAI-kompatible API, Gruppenverwaltung, Swagger UI, Tagesmeldung, erweitertes Audit-Logging, Keycloak 26.5.6 | – |
| 1.6.x | 2026-03-07 | App-Freigabe, Reasoning-Modelle, Speech-to-Text, vLLM als Inferenz-Engine (TGI im Wartungsmodus) | – |
| 1.5.x | 2025-12-12 | Lizenzverwaltung für Server, Split-Screen-UI, Dokumentationsseite online | – |
| 1.1.x | 2025-10-28 | Erstes 1.x-Release: neues Frontend (Vue.js), neue Extraktions-Pipeline, OCR | – |
Details je Release: Changelog.
Migrationshinweis ab 1.8.6
basebox 1.8.6 ergänzt die AISRV-Datenbankmigration V32. Eine Rückkehr zu einer AISRV-Version älter als 1.8.6 erfordert die Wiederherstellung des AISRV-Datenbank-Backups von vor dem Upgrade zusammen mit dem früheren Helm-Release. Sichern Sie vor jedem Upgrade – siehe Updates.
Geprüfte Infrastrukturversionen
Diese Versionen wurden von basebox mit dem Server Preparation Guide geprüft (Stand Februar 2026). Sie sind Prüfstände, keine Mindestanforderungen; die Mindestanforderungen des Charts stehen darunter.
| Komponente | Geprüfte Version |
|---|---|
| Ubuntu | 24.04 LTS |
| NVIDIA-Treiber | 580.126.09 |
| CUDA Toolkit | 13.0 (12.9 als Rückfalloption) |
| Docker | 29.2.1 |
| Kubernetes | 1.33.7 |
| Helm | 3.20.0 |
| Calico CNI | 3.31.3 |
| NVIDIA GPU Operator | aktuell über Helm |
Mindestanforderungen des Charts: Kubernetes 1.23+, Helm 3.x, dynamische Volume-Bereitstellung, ein Ingress-Controller, NVIDIA GPU Operator (oder Vergleichbares) auf GPU-Knoten – siehe Helm-Chart-Übersicht.
Geprüfte Inferenz-Kombinationen
| basebox | Inferenz-Runtime | Modell | Kontext |
|---|---|---|---|
| 1.7.1 | vLLM 0.15.0 (externer Endpunkt) | openai/gpt-oss-20b |
32.768 |
Weitere geprüfte Modelle und Konfigurationen: Getestete Modelle und Referenzkonfigurationen. GPT-OSS-Modelle benötigen vLLM 0.10.1 oder neuer.
Kompatibilitätsregeln
- Chart und App-Version gehören zusammen. Installieren Sie immer die Chart-Version, die zur gewünschten basebox-Version gehört; mischen Sie keine Einzelcharts unterschiedlicher Stände.
- Upgrades in Reihenfolge. Datenbanken zuerst (bei Schemaänderungen), dann Backend-Dienste, IDP, Inferenz, zuletzt Frontend – so führt es
helm upgrademit dem Umbrella-Chart aus. - Downgrades brauchen ein Backup. Datenbankmigrationen sind vorwärts gerichtet.
- Inferenz ist entkoppelt. Die Inferenz-Runtime kann unabhängig von basebox aktualisiert werden, solange sie die OpenAI-kompatible API (
/v1/models,/v1/chat/completions) weiter erfüllt und denselben Modellbezeichner meldet.
Benötigen Sie Hilfe? Support kontaktieren