docker run¶
Erzeugt aus einem Image einen Container und startet ihn.

Syntax¶
docker run [OPTIONEN] IMAGE [BEFEHL [ARG...]]
Optionen¶
| Option | Beschreibung |
|---|---|
-d, --detach |
Im Hintergrund laufen lassen und die Container-ID ausgeben |
--name NAME |
Name des Containers, sonst wählt Docker einen zufälligen |
-p HOST:CONTAINER |
Einen Port veröffentlichen, etwa -p 8080:80 |
-v QUELLE:ZIEL[:ro] |
Ein Volume oder ein Host-Verzeichnis einhängen |
-e NAME=WERT |
Eine Umgebungsvariable setzen |
--restart REGEL |
Automatisch neu starten: no, on-failure, always, unless-stopped |
--rm |
Den Container löschen, sobald er stoppt |
-it |
Interaktiv mit Terminal, für eine Shell im Container |
--network NAME |
Den Container mit diesem Netzwerk verbinden |
Beispiele¶
nginx im Hintergrund starten:
docker run -d --name web -p 8080:80 --restart unless-stopped nginx:1.28
0d306f9f64bf095289aac92fd5543790da5bff50734f905a8073759a819f9d2e
Die lange Zeichenkette ist die ID des neuen Containers. nginx antwortet jetzt auf Port 8080 des Servers.
Eine Datenbank mit einem Volume für ihre Daten:
docker run -d --name db -e POSTGRES_PASSWORD=secret \
-v pgdata:/var/lib/postgresql/data postgres:17
f1971ec6019cd6b63bec27e35dd69ceae4e9504716d98e74ba691b6989040cae
Einen Befehl einmal ausführen und den Container entfernen:
docker run --rm debian:trixie cat /etc/debian_version
13.1
Eine Shell in einem frischen Container:
docker run --rm -it ubuntu:24.04 bash
root@5c1e8d3a7f20:/# cat /etc/lsb-release | tail -1
DISTRIB_DESCRIPTION="Ubuntu 24.04.3 LTS"
root@5c1e8d3a7f20:/# exit
exit beendet die Shell, und --rm löscht den Container sofort.
Beim ersten Start wird das Image heruntergeladen:
docker run hello-world
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
4f55086f7dd0: Pull complete
Digest: sha256:11a3eb1597e864c51b3f56733cb2e8a90bf0c284bfc05f9444d81c558bc848aa
Status: Downloaded newer image for hello-world:latest
Hello from Docker!
This message shows that your installation appears to be working correctly.
...
Wann brauche ich das?¶
- Um einen Dienst wie einen Webserver oder eine Datenbank im Container zu starten
- Um ein Werkzeug oder eine andere Distribution auszuprobieren, ohne etwas zu installieren
- Um eine einmalige Aufgabe, etwa einen Datenbank-Dump, in einem frischen Container auszuführen
Neustart nach einem Reboot
Ohne --restart bleibt ein Container nach dem Neustart des Servers gestoppt. Nimm für
Dienste --restart unless-stopped.
Ports umgehen die Firewall
Mit -p veröffentlichte Ports trägt Docker direkt in den Paketfilter ein, an den Regeln
von ufw und firewalld vorbei. Binde Ports, die nur der Host braucht, an localhost:
-p 127.0.0.1:5432:5432.