---
title: "Registry weg, Internet weg: Startet Ihr Docker-Stack noch?"
date: 2026-11-15T17:19:18+01:00
modified: 2026-11-15T19:12:40+01:00
category: docker
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/ernstfall-docker-registry-internet-weg-offline-start
keywords:
  - Ernstfall
  - Docker
  - Docker Compose
  - Registry
  - Offline
  - docker save
  - Troubleshooting
reading_time: 7
ai_notice: "Mit KI erstellt – redaktionelle Prüfung ausstehend"
---

# Registry weg, Internet weg: Startet Ihr Docker-Stack noch?

> Mit KI erstellt – redaktionelle Prüfung ausstehend ([KI-Transparenz](https://s-edv.com/ki-transparenz))

Docker Hub ist nicht erreichbar, das Internet am Standort ist ausgefallen, oder der Server steht hinter einer Firewall, die gerade jemand umgebaut hat. Läuft dann noch alles? Und was passiert, wenn genau jetzt jemand ein Update einspielt oder den Server neu startet? Für diese Anleitung lief ein kleiner Stack aus zwei Diensten in zwei Umgebungen: einmal ganz ohne Internet, einmal mit einer Registry, die keine Antwort gibt. Elf typische Schritte wurden je dreimal ausprobiert.

**Dies ist Teil 9 der Reihe „Ernstfall“.** Jeder Teil macht absichtlich etwas kaputt, misst, was passiert, und zeigt den Weg zurück.

**Kurzfassung:** Solange die Images auf dem Server liegen, braucht Docker keine Registry: Start, Neustart des Daemons, `down` und `up` und sogar ein Build auf einem vorhandenen Basis-Image klappten ohne Netz. Alles, was ein Image holen will, scheiterte. Ohne Internet kam der Fehler nach weniger als einer Sekunde, bei einer Registry ohne Antwort erst nach rund 30 Sekunden. Fehlte ein einziges Image, startete `docker compose up -d` keinen Dienst des Stacks. Gerettet hat eine Sicherung der Images mit `docker save`.

## Was Sie brauchen

- [ ] Einen Linux-Server mit Docker und Docker Compose, siehe [Docker und Docker Compose auf Linux installieren](https://s-edv.com/anleitungen/docker-compose-linux-selfhosting-grundlage).
- [ ] Feste Versionen in der `compose.yaml`, zum Beispiel `redis:8.10.3` statt `redis:latest`.
- [ ] Platz für eine Sicherung der Images in ungefähr der Größe, die `docker image ls` anzeigt.

## Schritt 1: Images sichern, solange das Netz da ist

Die Images eines Stacks sichern Sie mit `docker save` in eine Datei. Nennen Sie alle Images, die Ihre `compose.yaml` verwendet. Im Test wurde das Redis-Image auf diesem Weg gesichert und wieder geladen:

```bash
$ docker save -o /backup/stack-images.tar alpine:3.24.4 redis:8.10.3
```

Legen Sie die Datei dorthin, wo auch Ihre übrige Sicherung liegt. Wiederholen Sie den Befehl nach jedem Update, damit die gesicherten Images zu den Versionen in der `compose.yaml` passen.

> **Prüfen:** **Verifizieren:** `tar tf /backup/stack-images.tar | head` listet den Inhalt der Sicherung.

## Schritt 2: Ohne Netz starten, ohne zu ziehen

Ist die Registry weg, starten Sie den Stack ohne jede Pull-Option. Mit vorhandenen Images reicht der normale Befehl:

```bash
$ docker compose up -d
```

Verzichten Sie in dieser Lage auf `docker compose pull`, `--pull always` und auf neue Tags in der `compose.yaml`. Steht in der Datei `pull_policy: always`, scheitert `up -d`. Laufende Container blieben im Test dabei in Betrieb, ein gestoppter Stack käme so aber nicht hoch. Nehmen Sie die Zeile heraus.

> **Prüfen:** **Verifizieren:** `docker compose ps` zeigt alle Dienste als `Up`.

## Schritt 3: Fehlende Images aus der Sicherung laden

Fehlt ein Image, etwa weil es nach einem Aufräumen gelöscht wurde, laden Sie es aus der Sicherung und starten erneut:

```bash
$ docker load -i /backup/stack-images.tar
$ docker compose up -d
```

> **Prüfen:** **Verifizieren:** `docker load` meldet für jedes Image eine Zeile `Loaded image`, danach laufen alle Dienste.

## So wurde gemessen

Getestet mit Docker 29.9.3 und Docker Compose 5.7.1 in zwei eigenen Docker-Daemons, die selbst in Containern liefen. Der erste hing in einem Netz ohne Zugang nach außen, dort scheiterte schon die Namensauflösung. Beim zweiten zeigten die Adressen von Docker Hub auf eine Adresse, die nie antwortet, so wie bei einer Registry, die nicht mehr reagiert. Der Stack bestand aus `alpine:3.24.4` und `redis:8.10.3`, beide mit `restart: unless-stopped`. Die Images kamen vorab per `docker load` in die Daemons. Jeder der elf Schritte lief in jeder Umgebung dreimal. Vor jedem Durchgang wurden die Images frisch geladen, innerhalb eines Durchgangs liefen die Schritte nacheinander auf demselben Stand.

## Ergebnis 1: Was ohne Registry geht

![Übersicht: Docker-Befehle ohne Internet und mit hängender Registry, Start und Build klappen, Pull scheitert, ein fehlendes Image stoppt den ganzen Stack](https://s-edv.com/uploads/2026/11/0e0f243a5f2ff7672a121b95a098f8dc2e98732aca792e47d48ae0c4a4856f9d-1024.png)
*Zehn der elf Schritte ohne Internet und mit nicht antwortender Registry: Start, Neustart und Build klappen, alles mit Pull scheitert*

Alles, was mit vorhandenen Images auskommt, lief in beiden Umgebungen ohne Fehler: der Start mit `up -d`, `down` und erneutes `up -d`, ein Neustart des Docker-Daemons, nach dem beide Container dank `restart: unless-stopped` von selbst wieder liefen, und ein Build, dessen Basis-Image schon da war. Der Daemon lief dabei selbst in einem Container. Im Test fragte Docker die Registry nur, wenn es etwas holen sollte.

## Ergebnis 2: Wann es scheitert und wie lange das dauert

Gescheitert ist alles, was ein Image holen will: `docker compose pull`, `up -d --pull always`, `pull_policy: always` in der `compose.yaml` und ein neuer Tag, der noch nicht auf dem Server lag. Die bestehenden Container liefen dabei weiter. Ohne Internet kam der Fehler nach weniger als einer Sekunde, weil schon der Name nicht aufgelöst wurde:

Ausgabe:

```plaintext
Error failed to resolve reference "docker.io/library/alpine:3.24.4": failed to do request: Head "https://registry-1.docker.io/v2/library/alpine/manifests/3.24.4": dial tcp: lookup registry-1.docker.io on 127.0…
```

Bei einer Registry, die nicht antwortet, wartete Docker jedes Mal 30,2 bis 30,7 Sekunden, bevor es aufgab:

Ausgabe:

```plaintext
Error failed to resolve reference "docker.io/library/alpine:3.24.4": failed to do request: Head "https://registry-1.docker.io/v2/library/alpine/manifests/3.24.4": dial tcp 10.255.255.1:443: i/o timeout
```

Mit zwei Images dauerte `docker compose pull` insgesamt rund 30 Sekunden. Ein Update-Skript, das mehrere Stacks nacheinander zieht, wartet entsprechend für jeden.

## Ergebnis 3: Ein fehlendes Image legt den ganzen Stack lahm

Der unangenehmste Fall: Nach `docker compose down` wurde das Image von Redis gelöscht, wie es ein Aufräumen mit `docker image prune -a` tun würde. Danach startete `docker compose up -d` überhaupt keinen Dienst, auch nicht den mit vorhandenem Image. In allen sechs Läufen, drei je Umgebung, lief danach kein Container. Bei hängender Registry dauerte der ganze Schritt mit `down` und `up` bis zu 42,0 Sekunden, ohne Internet rund 11 Sekunden. Erst `docker load` aus einer Sicherung des fehlenden Images brachte den Stack zurück, ebenfalls in allen sechs Läufen.

## Was das für Ihren Server heißt

Ein laufender Server kommt ohne Registry gut aus, auch über einen Neustart hinweg. Gefährlich sind zwei Dinge: Updates zum falschen Zeitpunkt und Aufräumen. Wer bei einem Netzausfall `pull` versucht, verliert Zeit, aber keine Dienste. Wer vorher Images gelöscht hat, steht ohne Sicherung mit einem toten Stack da.

Löschen Sie deshalb keine Images von gestoppten Stacks, solange Sie sie noch brauchen, siehe [Teil 6 der Reihe zu Löschbefehlen](https://s-edv.com/anleitungen/ernstfall-docker-volumes-geloescht-down-v-prune). Halten Sie die Images Ihrer wichtigen Dienste per `docker save` vor, oder betreiben Sie einen eigenen Registry-Spiegel im lokalen Netz. Der hilft allerdings nur mit Images, die er vorher schon zwischengespeichert hat. Und ändern Sie bei einem Netzausfall keine Versionen in der `compose.yaml`: Ein neuer Tag verlangte im Test jedes Mal einen Download.

## Typische Fehler

**`dial tcp: lookup registry-1.docker.io on …`**

Der Name der Registry lässt sich nicht auflösen, der Server hat kein Internet oder keinen DNS. Hinter `on` steht die Adresse Ihres DNS-Servers. Starten Sie ohne Pull wie in Schritt 2.

**`dial tcp …:443: i/o timeout` nach rund 30 Sekunden**

Die Registry ist nicht erreichbar, aber der Name wird aufgelöst. Docker wartete im Test jedes Mal rund 30 Sekunden bis zur Fehlermeldung.

**Nach `docker compose up -d` läuft kein einziger Dienst**

Mindestens ein Image fehlt lokal und lässt sich nicht holen. Compose startete im Test dann keinen Dienst des Stacks. Laden Sie die Images wie in Schritt 3.

## Häufige Fragen

### Hilft pull_policy: missing?

Das ist laut Compose-Dokumentation die Voreinstellung für Dienste ohne eigenen Build, und sie war im Test aktiv. Sie holt nur fehlende Images. Fehlt eines und die Registry ist weg, hilft sie nicht, genau das zeigt Ergebnis 3.

### Was ist mit Builds?

Ein Build mit `docker compose build` klappte im Test ohne Registry, das Basis-Image aus der Zeile `FROM` lag dabei auf dem Server. Auch `docker build --pull=false` lief durch.

## Fazit

Docker ist ohne Registry robuster, als man denkt: Was auf dem Server liegt, startet, auch nach einem Neustart. Kritisch wird es, wenn Images fehlen, denn dann bleibt der ganze Stack aus. Eine Sicherung der Images mit `docker save` kostet wenig Platz und machte im Test aus einem toten Stack in Sekunden einen laufenden. Im nächsten Teil der Reihe ist das Admin-Passwort weg.

## Weiterführende Anleitungen und Quellen

- [Ernstfall Teil 11: Zertifikat abgelaufen, Uhr falsch](https://s-edv.com/anleitungen/ernstfall-zertifikat-abgelaufen-uhr-falsch)
- [Ernstfall Teil 12: SQLite auf der Netzfreigabe](https://s-edv.com/anleitungen/ernstfall-sqlite-netzfreigabe-smb-nobrl)
- [Ernstfall Teil 13: Harter Abbruch](https://s-edv.com/anleitungen/ernstfall-harter-abbruch-kill-datenbank-redis)
- [Ernstfall Teil 1: Datenbank im laufenden Betrieb kopiert](https://s-edv.com/anleitungen/ernstfall-datenbank-live-kopiert-backup-kaputt)
- [Ernstfall Teil 2: Platte voll](https://s-edv.com/anleitungen/ernstfall-platte-voll-docker-dienste-datenbanken)
- [Ernstfall Teil 3: Update zurückdrehen](https://s-edv.com/anleitungen/ernstfall-update-zurueckdrehen-downgrade-docker)
- [Ernstfall Teil 4: PostgreSQL 16 auf 18 per Tag](https://s-edv.com/anleitungen/ernstfall-postgresql-16-auf-18-tag-upgrade)
- [Ernstfall Teil 5: Container-Logs fluten die Platte](https://s-edv.com/anleitungen/ernstfall-docker-logs-platte-voll-max-size)
- [Ernstfall Teil 7: Angreifer kennt das Backup-Passwort](https://s-edv.com/anleitungen/ernstfall-ransomware-restic-append-only-angriff)
- [Ernstfall Teil 8: Restore-Rennen](https://s-edv.com/anleitungen/ernstfall-restore-rennen-restic-borgbackup-kopia)
- [Ernstfall Teil 10: Admin-Passwort weg](https://s-edv.com/anleitungen/ernstfall-admin-passwort-vergessen-zuruecksetzen-docker)
- [Ernstfall Teil 6: down -v, prune, rm](https://s-edv.com/anleitungen/ernstfall-docker-volumes-geloescht-down-v-prune)
- [Docker und Docker Compose auf Linux installieren](https://s-edv.com/anleitungen/docker-compose-linux-selfhosting-grundlage)
- [Docker-Container automatisch aktualisieren](https://s-edv.com/anleitungen/docker-container-updates-watchtower-nachfolger-diun-wud)
- [Docker: docker image save](https://docs.docker.com/reference/cli/docker/image/save/)
- [Docker: docker image load](https://docs.docker.com/reference/cli/docker/image/load/)
- [Docker Compose: pull_policy](https://docs.docker.com/reference/compose-file/services/#pull_policy)
- [Docker: Registry als Spiegel betreiben](https://docs.docker.com/docker-hub/image-library/mirror/)
