> ## Documentation Index
> Fetch the complete documentation index at: https://docs.varios-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update von 2026.10 auf 2026.11

> Schritt-für-Schritt-Anleitung für das Update einer On-Premise-Installation von 2026.10.x auf 2026.11 mit versionierten Presidio-Images

Diese Anleitung führt Sie durch das Update einer On-Premise-Installation von 2026.10.x auf 2026.11. Ab 2026.11 werden die DLP-Dienste `presidio-analyzer` und `presidio-anonymizer` mit der Produktversion ausgeliefert; dafür passen Sie die Imagenamen in der `docker-compose.yml` von Hand an.

`<ZIELVERSION>` steht für `2026.11` oder einen späteren Patch-Stand `2026.11.x`, den Ihnen das VARIOS AI-Team nennt. Als Installationsverzeichnis wird im Beispiel `/docker/variosai` verwendet.

> [!NOTE]
>
> Läuft Ihre Installation noch mit 2026.08.x, führen Sie zuerst das [Update von 2026.08 auf 2026.10](https://docs.varios-ai.com/de/monthly/operations/update-2026-08-to-2026-10.md) durch. Ein direktes Update von 2026.08 auf 2026.11 ist nicht vorgesehen.

## A. Vorab (vor dem Wartungsfenster)

1. Lassen Sie sich vom VARIOS AI-Team bestätigen, dass `<ZIELVERSION>` veröffentlicht ist.
2. Prüfen Sie Version und Plattenplatz:
   ```bash theme={null}
   cd /docker/variosai
   grep ^VERSION= .env           # 2026.10.x
   df -h /var/lib/docker         # >= 8 GB frei
   ```
3. Prüfen Sie die Anmeldung an der Container-Registry. Der Update-Dienst `varios-update.service` läuft als `root` und verwendet die Anmeldung von `root`, prüfen Sie deshalb mit `sudo`. Wenn Sie `docker` auch als eigener Benutzer ohne `sudo` aufrufen, prüfen Sie zusätzlich ohne `sudo`:
   ```bash theme={null}
   sudo docker login registry.varios-ai.com
   ```
4. Prüfen Sie, welche Anpassungen Ihre `docker-compose.yml` braucht:
   ```bash theme={null}
   grep -n 'presidio' docker-compose.yml
   grep -c 'STACKNAME' docker-compose.yml
   ```
   Ist die Anzahl für `STACKNAME` größer als 0, führen Sie in Abschnitt C auch Schritt 2 aus.

## B. Sicherung

Legen Sie einen Snapshot der virtuellen Maschine an. Fahren Sie erst danach fort. Weitere Hinweise finden Sie unter [Backup und Wiederherstellung](https://docs.varios-ai.com/de/monthly/operations/backup.md).

```bash theme={null}
cp -a .env .env.bak-$(date +%F)
cp -a docker-compose.yml docker-compose.yml.bak-$(date +%F)
```

## C. `docker-compose.yml` anpassen

Die `.env` bleibt unverändert. Ändern Sie `VERSION=` **nicht**.

**1. Presidio-Images umstellen:** Der folgende Befehl stellt beide DLP-Dienste auf die versionierten Images um.

```bash theme={null}
sed -i -E \
  -e 's#image: registry\.varios-ai\.com/(avency/|variosai/)?presidio-analyzer:.*#image: registry.varios-ai.com/variosai/presidio-analyzer:${VERSION}#' \
  -e 's#image: registry\.varios-ai\.com/(avency/|variosai/)?presidio-anonymizer:.*#image: registry.varios-ai.com/variosai/presidio-anonymizer:${VERSION}#' \
  docker-compose.yml
grep -n 'presidio' docker-compose.yml
```

Die beiden Dienste lauten danach:

```yaml theme={null}
  presidio-analyzer:
    image: registry.varios-ai.com/variosai/presidio-analyzer:${VERSION}
    restart: always
    networks:
      - internal

  presidio-anonymizer:
    image: registry.varios-ai.com/variosai/presidio-anonymizer:${VERSION}
    restart: always
    networks:
      - internal
```

**2. Nur wenn `STACKNAME` vorkommt:** Der folgende Befehl gibt den Traefik-Routern den festen Namen `variosai`.

```bash theme={null}
sed -i 's/\${STACKNAME}/variosai/g' docker-compose.yml
grep -n 'traefik.http' docker-compose.yml
```

Verweisen eigene Dateien unter `traefik/dynamic/` auf einen Router- oder Service-Namen, passen Sie diese ebenfalls an.

> [!WARNING]
>
> Führen Sie nach diesen Änderungen bis zum Update in Abschnitt D kein `docker compose up -d` und kein `docker compose pull` aus. Die Presidio-Images gibt es erst ab 2026.11; mit der noch eingetragenen Version 2026.10.x schlägt der Start mit `manifest unknown` fehl.

Prüfen Sie die Datei:

```bash theme={null}
docker compose config --quiet && echo OK
docker compose config | grep -E 'image: .*presidio'   # beide mit variosai/presidio-…
```

## D. Update ausführen

Wählen Sie eine der beiden Varianten. Wie der Update-Dienst arbeitet, beschreibt [systemd-Dienst](https://docs.varios-ai.com/de/monthly/security/systemd-service.md).

> [tab] Datei update\_version
>
> 1. ```bash theme={null}
>    systemctl is-active varios-update.service     # active
>    ```
> 2. ```bash theme={null}
>    echo "<ZIELVERSION>" > update_version
>    ```
> 3. Fortschritt verfolgen bis `Update successfully completed`:
>    ```bash theme={null}
>    journalctl -u varios-update.service -f
>    ```

> [tab] Manuell
>
> ```bash theme={null}
> sudo systemctl stop varios-update.service
> sed -i "s/^VERSION=.*/VERSION=<ZIELVERSION>/" .env
> echo "<ZIELVERSION>" > update_version
> docker compose pull
> docker compose up -d
> docker compose ps
> docker compose exec php ./update.sh
> docker system prune -f -a --volumes
> sudo systemctl start varios-update.service
> ```

## E. Prüfen

1. ```bash theme={null}
   docker compose ps                                              # alle running, presidio-analyzer und presidio-anonymizer healthy
   docker compose images | grep -E 'php|presidio|code-interpreter'   # alle <ZIELVERSION>
   docker compose exec php curl -s http://presidio-analyzer:3000/health
   ```
2. In der Oberfläche zeigt **System Informationen** `<ZIELVERSION>`, und **Dienstzustände** enthält keine roten Einträge.
3. Senden Sie in einem Chat mit aktivem DLP einen Text mit Namen und IBAN, zum Beispiel „Max Mustermann, IBAN DE89 3704 0044 0532 0130 00“. Beide Treffer werden erkannt.
4. Laden Sie ein PDF mit personenbezogenen Daten hoch. Die DLP-Prüfung läuft durch und zeigt die Treffer.
5. Stellen Sie einem Assistenten mit Dateien eine Frage, deren Antwort aus seinen Dateien stammen muss.
6. ```bash theme={null}
   systemctl is-active varios-update.service     # active
   ```

> [!NOTE]
>
> Ab 2026.11 gibt VARIOS AI angehängte Dateien und Assistenten-Dateien vollständig an das Modell weiter, solange sie in dessen Kontextfenster passen. Das kann den Token-Verbrauch erhöhen. Anteil und Obergrenze legen Sie in den [Experteneinstellungen](https://docs.varios-ai.com/de/monthly/admin/settings/expert-settings.md) unter **Dateiinhalte im Kontext** fest.

## F. Wenn etwas fehlschlägt

| Meldung / Symptom | Maßnahme |
| - | - |
| `docker compose pull` meldet `manifest unknown` für `presidio-analyzer` oder `presidio-anonymizer` | Abschnitt C, Schritt 1 wiederholen; beide Images müssen auf `registry.varios-ai.com/variosai/presidio-…:${VERSION}` zeigen |
| `docker compose pull` meldet `unauthorized` oder `denied` | `sudo docker login registry.varios-ai.com` ausführen; wenn Sie `docker` ohne `sudo` aufrufen, zusätzlich `docker login registry.varios-ai.com` |
| `presidio-analyzer` bleibt `starting` oder `unhealthy` | `docker compose logs presidio-analyzer` prüfen; das Laden der Sprachmodelle dauert nach dem Start einige Sekunden |
| VARIOS AI ist nicht mehr per HTTPS erreichbar oder HTTP leitet nicht um | Traefik-Labels des Dienstes `php` mit der Sicherung aus Abschnitt B vergleichen (Abschnitt C, Schritt 2), `docker compose logs traefik` prüfen |
| **Version ändern** meldet „Diese Version kann noch nicht installiert werden“ | Gewollt: Das Update auf 2026.11 ist in der Oberfläche gesperrt, damit Abschnitt C nicht übersprungen wird. Führen Sie es nach Abschnitt D aus. Läuft noch 2026.08.x, zuerst das [Update von 2026.08 auf 2026.10](https://docs.varios-ai.com/de/monthly/operations/update-2026-08-to-2026-10.md) durchführen |
| `update.sh` bricht ab | Meldung lesen, Ursache beheben, `docker compose exec php ./update.sh` erneut ausführen |
| `.env` zeigt wieder die alte `VERSION` | `VERSION` wurde bei laufendem Update-Dienst von Hand geändert → Abschnitt D, Variante **Datei update\_version** oder **Manuell** |

> [!WARNING]
>
> **Rollback:** Spielen Sie den VM-Snapshot zurück. Führen Sie kein Downgrade über **Version ändern** aus.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.