# Portainer 2.40.0 → 2.42.6 — Rollback-Runbook (2026-08-28)

## Voraussetzungen
- pve `.100`, dort LXC 400 (Docker-LXC auf vlan20)
- Portainer-Container läuft mit den unten dokumentierten Flags
- Pre-Upgrade-Image-Tag `portainer/portainer-ce:2.40.0-preupgrade-20260828` ist vorhanden

## Was hier dokumentiert ist
1. **Image-Tag** mit dem Stand VOR dem Bump (für 1-Befehl-Rollback).
2. **Runflags** des Containers (docker inspect-Auszug).
3. **Volume-Mount** `/var/lib/docker/volumes/portainer_data/_data → /data`
   (Portainer-Persistenz: alle Stacks, Endpoint-Configs, Users, API-Tokens).
   Volume bleibt **unangetastet** beim Image-Swap — Settings überleben den Bump.

## Runflags (aus `docker inspect portainer --format '{{json .HostConfig}}'`)
| Property | Wert |
|---|---|
| Image | `portainer/portainer-ce:2.42.6` (Bump) bzw. `:2.40.0-preupgrade-20260828` (Rollback) |
| Restart | `always` |
| Network | `bridge` (default), MACVLAN über das Compose-Netzwerk |
| Privileged | `false` |
| Ports | `8000/tcp → 8000`, `9443/tcp → 9443` |
| Mounts | `/var/run/docker.sock → /var/run/docker.sock` (Pflicht), `/var/lib/docker/volumes/portainer_data/_data → /data` |

## Originaler Run-Befehl (rekonstruiert)
```bash
docker run -d \
  --name portainer \
  --restart always \
  -p 8000:8000 \
  -p 9443:9443 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes/portainer_data/_data:/data \
  portainer/portainer-ce:2.40.0
```

## Rollback-Schritte (Bump macht Probleme)
```bash
# 1. Auf pve (LXC 400)
ssh root@10.40.20.100 "pct exec 400 -- bash -c '
  docker stop portainer
  docker rm portainer
  docker run -d \\
    --name portainer \\
    --restart always \\
    -p 8000:8000 -p 9443:9443 \\
    -v /var/run/docker.sock:/var/run/docker.sock \\
    -v /var/lib/docker/volumes/portainer_data/_data:/data \\
    portainer/portainer-ce:2.40.0-preupgrade-20260828
'"
# 2. API-Token ist volume-gebunden → bleibt gültig, keine Re-Auth.
# 3. Verifikation: ein curl gegen die Settings-API reicht.
```

## Cleanup nach erfolgreichem Bump
Nach ≥7 Tagen Stabilität den `:preupgrade-20260828`-Tag löschen:
```bash
ssh root@10.40.20.100 "pct exec 400 -- docker rmi portainer/portainer-ce:2.40.0-preupgrade-20260828"
```