By Ralf-Peter Kleinert
In meiner Paperless Installations-Anleitung habe ich hier auf dem Blog als auch in meinen YouTube-Videos das Repository: docker.io verwendet. Das ist im Kern nicht falsch, da es direkt aus den offiziellen Paketquellen derverwendeten Linux-Distro stammt und für einen stabilen Betrieb ausreicht.
Kurze Einleitung und Erklärung
Möchten man sein System allerdings auf eine neue Docker-Major-Version aktualisieren oder mit apt update immer die neueste Version erhalten, stößt das docker.io Paket schnell an seine Grenzen. Die Paketverwalter von Debian bzw. Ubuntu „fixieren“ die Hauptversionen innerhalb eines Distro-Release ein und liefern dort meist nur noch Bugfixes aus. Wer die volle Kontrolle über seine Container-Umgebung behalten will und immer die aktuellste Docker-Engine nutzen möchte, sollte daher auf das offizielle Repository docker-ce von Docker umsatteln.
Wenn Sie nach meinen Anleitungen ihr Paperless installiert haben, dann bekommen Sie beim absetzen des Befehles:
docker --version
folgende, oder eine ähnliche Ausgabe:
Docker version 26.1.5+dfsg1, build a72d7cd
Mit dem Befehl ohne —
docker version
erhalten Sie eine detailliertere Ausgabe wie:
Client:
Version: 26.1.5+dfsg1
API version: 1.45
Go version: go1.24.4
Git commit: a72d7cd
Built: Thu Aug 13 05:35:47 2026
OS/Arch: linux/amd64
Context: default
Server:
Engine:
Version: 26.1.5+dfsg1
API version: 1.45 (minimum version 1.24)
Go version: go1.24.4
Git commit: 411e817
Built: Thu Aug 13 05:35:47 2026
OS/Arch: linux/amd64
Experimental: false
containerd:
Version: 1.7.24ds1
runc:
Version: 1.1.15+ds1
GitCommit: 1.1.15+ds1-2+b4
docker-init:
Version: 0.19.0
GitCommit:
In diesen Ausgaben ist ersichtlich, dass das Paket direkt aus den Debian- bzw. Ubuntu-Paketquellen bezogen wurde. Das Kürzel dfsg steht für Debian Free Software Guidelines und kennzeichnet diese von der Linux-Distro bereitgestellte Version.
Obwohl diese Version weiterhin stabil läuft, ist die Hauptversion 26 lange nicht mehr die aktuellste Version von Docker. Aktuell steht Docker in der Version 29.x zur Verfügung. Sie enthält viele Performance-Optimierungen, erweiterte Sicherheitsfunktionen und eine bessere Unterstützung für erweiterte Container-Features.
Wenn Sie nun versuchen, Ihr System mit dem gewohnten Befehl apt update && apt upgrade zu aktualisieren, werden Sie sehen, dass Docker auf Version 26 verbleibt.
Um Ihre Paperless-VM und alle anderen Container auf die neueste Docker-Version 29 zu bringen, müssen Sie das System einmalig von den docker.io Paketen auf das offizielle Repository von Docker umstellen.
Schnelle Schritt für Schritt-Anleitung um docker.io gegen docker-ce auszuwechseln
Schritt 1
Vollbackup der Paperless-VM. Vollziehen Sie keinesfalls diese Schritte, wenn sie kein vollständiges und funktionierendes Backup ihrer Paperless-Maschine haben!
Schritt 2
Alle Container stoppen, in diesem Falle Paperless:
cd /opt/paperless
Fährt alle Container herunter, die in der docker-compose.yml definiert sind
docker compose down
Altes docker.io Paket entfernen (Container/Daten bleiben in /var/lib/docker erhalten):
apt remove -y docker.io docker containerd runc docker-buildx docker-compose docker-cli
Schritt 3
Docker GPG-Key & Repository hinzufügen:
apt update
Sollte bereits installiert sein, aber zur Sicherheit:
apt install -y ca-certificates curl gnupg
Der Befehl erstellt das Verzeichnis /etc/apt/keyrings mit Schreibrechten, falls es noch nicht existiert:
install -m 0755 -d /etc/apt/keyrings
Lädt den GPG-Schlüssel von Docker herunter und speichert ihn lokal als Datei – damit kann apt später prüfen, dass die Pakete echt sind:
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
Dieser Befehl macht den GPG-Schlüssel für alle Benutzer lesbar. Somit kann apt darauf zugreifen:
chmod a+r /etc/apt/keyrings/docker.asc
Hiermit fügen Sie das offizielle Docker-Repository zu Ihren Paketquellen hinzu. apt weiß dann, wo es die neueste Docker-Version findet:
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
tee /etc/apt/sources.list.d/docker.list > /dev/null
Schritt 4
Das eben hinzugefügte, offizielle Docker (v29.x) installieren
apt update
docker-cd und seine Abhängigkeiten installieren:
apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras pigz
Schritt 5
Nach dem Upgrade bzw. Wechsel der Docker-Engine, Paperless wieder hochfahren:
cd /opt/paperless
docker compose up -d
Schritt 6
Nochmaliges prüfen der Docker-Version:
docker --version
docker version
Ralf-Peter Kleinert / ComputerRalle
Ich verwende moderne KI-Systeme als unterstützendes Werkzeug, um meine Texte zu strukturieren, sprachlich zu überarbeiten und in eine verständliche Form zu bringen. Dabei nutze ich Künstliche Intelligenz unter anderem zur Korrektur von Rechtschreibung und Grammatik, zur besseren Gliederung von Inhalten sowie zur Optimierung von Formulierungen. Dennoch schreibe ich meine Inhalte zunächst komplett alleine. Bilder und Thumbnails bearbeite ich wieder komplett selbst in Photoshop. KI-Bilder sehen alle gleich aus – das passt mir nicht. KI zum korrigieren zu verwenden ist für mich eine enorme Zeitersparnis, sodass ich mich stärker auf die eigentlichen Inhalte konzentrieren kann.