{"id":3809,"date":"2025-02-27T16:30:00","date_gmt":"2025-02-27T15:30:00","guid":{"rendered":"https:\/\/ictknow-how.ch\/blog\/?p=3809"},"modified":"2025-05-05T11:24:25","modified_gmt":"2025-05-05T09:24:25","slug":"wie-installiert-man-docker-direkt-in-wsl2-unter-windows","status":"publish","type":"post","link":"https:\/\/ictknow-how.ch\/blog\/2025\/02\/27\/wie-installiert-man-docker-direkt-in-wsl2-unter-windows\/","title":{"rendered":"Wie installiert man docker direkt in WSL2 unter Windows?"},"content":{"rendered":"\n

Die meisten kennen vermutlich \u00abDocker Desktop f\u00fcr Windows AMD64<\/a>\u00bb. Dieses offizielle Installationsprogramm installiert ein sch\u00f6nes GUI. Darum geht es in diesem Artikel nicht!<\/p>\n\n\n\n

Hier geht es darum, wie man docker<\/strong> in der WSL2-Kommandozeile<\/strong> direkt installiert, ohne GUI, ohne sch\u00f6ne Icons.<\/p>\n\n\n\n

Folgende Punkte sind zur Installation notwendig:<\/p>\n\n\n\n

    \n
  1. Windows 10, Version 1903, Build 18362 oder neuer<\/strong> (kam im Mai 2019 raus)

    <\/li>\n\n\n\n
  2. WSL2. Installiert man \u00fcber eine PowerShell-Kommandozeile mit Administratorrechten mit:
    wsl --install<\/code>

    <\/li>\n\n\n\n
  3. WSL2 zur Standard-Version machen:
    wsl --set-default-version 2<\/code>
    \"Installation

    Nun muss man die PowerShell-Kommandozeile schliessen und Windows neu starten.


    <\/li>\n\n\n\n
  4. Nach dem Windows-Neustart \u00f6ffnet man erneut eine PowerShell-Kommandozeile mit Administratorrechten und installiert eine Linux-Distro unter WSL2, z.B. \u00abUbuntu\u00bb mit:
    wsl --install<\/code> ubuntu
    \"Distro

    Jetzt kann man das neu verf\u00fcgbare WSL2<\/strong>
    (W<\/strong>indows S<\/strong>ubsystem for L<\/strong>inux) \u00fcber das entsprechende Icon im Startmenu starten.
    <\/a><\/a>\"\" \"\"

    Hinweis f\u00fcr Benutzer von VMWare Workstation:<\/em><\/strong>
    Wer sein Windows zu Testzwecken in einer virtuellen Maschine betreibt, darf nicht vergessen, dass f\u00fcr die Ausf\u00fchrung von WSL2<\/strong> die folgenden VM-Prozessoreinstellungen vor dem virtuellen Windows-Start zwingend n\u00f6tig sind:
    \"\"
    Bei der Erstverwendung<\/strong> der Distro in der WSL2 wird man aufgefordert f\u00fcr diese neue Distro einen Benutzer und ein Passwort zu setzen:
    \"\"
    In diesem Beispiel wurde als Benutzer: my_ubuntu_user<\/strong> gew\u00e4hlt, welchen man sp\u00e4ter im WSL2-Ubuntu-Prompt wieder erkennt.


    <\/li>\n\n\n\n
  5. Die eben installierte Linux-Distro innerhalb WSL2 (meist \u00abUbuntu\u00bb) sollte man auf den neuesten Softwarestand aktualisieren mit:
    sudo apt update && sudo apt upgrade -y<\/code>
    (Hinweis: Alle Befehle die man ab jetzt unter WSL2\/Ubuntu eingibt, sind normale Linux-\/Ubuntu-Befehle, wie man sie auch in einer Original-Ubuntu-Installation eingeben w\u00fcrde.)<\/em>


    <\/li>\n\n\n\n
  6. Damit man docker<\/strong> direkt in WSL2<\/strong> installieren kann – und damit kein \u00abDocker Desktop GUI unter Windows\u00bb braucht – sind folgende Voraussetzungen<\/strong> n\u00f6tig
    (alle folgenden Linux-\/Ubuntu-Befehle immer auf 1 Zeile ohne Umbr\u00fcche eingeben):
    sudo apt install apt-transport-https ca-certificates curl software-properties-common -y<\/code>
    (Hinweis: Unter Ubuntu\/Linux spricht man bei zus\u00e4tzlich zu installierender Software von Paketen. Hier werden die Pakete mit dem Namen „apt-transport-https“, „ca-certificates“, „curl“ und „sofware-properties-common“ installiert.)<\/em>

    Die n\u00e4chsten Punkte 7 und 8 beinhalten Befehle die eine neue Docker-Repository-Quelle f\u00fcr die aktuelle Ubuntu-Version einrichten und sicherstellen, dass nur authentische und signierte Pakete installiert werden:

    <\/li>\n\n\n\n
  7. Den offiziellen Docker GPG Schl\u00fcssel<\/strong> herunterladen und hinzuf\u00fcgen:
    curl -fsSL https:\/\/download.docker.com\/linux\/ubuntu\/gpg | sudo gpg --dearmor -o \/usr\/share\/keyrings\/docker-archive-keyring.gpg<\/code>
    (Mit dem lokal hinterlegten Original-GPG-Schl\u00fcssel wird sichergestellt, dass die neu heruntergeladenen Pakete authentisch und unver\u00e4ndert sind.)<\/em>

    <\/li>\n\n\n\n
  8. Das Ubuntu<\/strong> Repo einrichten:
    echo \"deb [arch=amd64 signed-by=\/usr\/share\/keyrings\/docker-archive-keyring.gpg] https:\/\/download.docker.com\/linux\/ubuntu $(lsb_release -cs) stable\" | sudo tee \/etc\/apt\/sources.list.d\/docker.list > \/dev\/null<\/code>
    (Damit wird die Ubuntu Repository-Quelle f\u00fcr Docker-Pakete von der offiziellen Docker-Website angegeben. Nur authentische und \u00fcberpr\u00fcfte Pakete f\u00fcr die amd64<\/code>-Architektur (64-Bit) werden installiert. Eine neue Datei <\/em>docker.list<\/code> wird erstellt, welche das Docker-Repository zur Liste der Paketquellen hinzuf\u00fcgt. Dieses wird beim Ausf\u00fchren von apt-get update<\/code> und apt-get install<\/code> verwendet.)<\/em>
    \"Zus\u00e4tzliche

    <\/li>\n\n\n\n
  9. Nun kann man docker<\/strong> in WSL2 installieren, mit:
    sudo apt update
    sudo apt install docker-ce -y<\/code>

    <\/li>\n\n\n\n
  10. Damit docker als Dienst<\/strong> jeweils automatisch zusammen mit WSL2 startet:
    sudo service docker start<\/code>
    <\/li>\n<\/ol>\n\n\n\n

    Mit folgenden Befehlen kann man pr\u00fcfen, ob docker in WSL2 l\u00e4uft, z.B. mit
    sudo docker ps -a<\/code>
    oder um alle vorhandenen docker container anzeigen lassen:
    sudo docker stats<\/code>
    \"docker
    (nach der Neuinstallation erscheinen logischerweise noch keine laufenden Container mit st\u00e4ndig aktualisierten Details wie die CPU-Auslastung. Diese Anzeige kann man mit der Tastenkombination Ctrl + C abbrechen und zum gr\u00fcnen Prompt zur\u00fcckkehren.)<\/em><\/p>\n\n\n\n

    Pr\u00fcfen ob docker richtig eingerichtet wurde und l\u00e4uft:
    sudo docker --version<\/code><\/p>\n\n\n\n

    Folgende Konfigurationsanpassungen sind n\u00fctzlich aber nicht zwingend n\u00f6tig:
    a)<\/strong> Eine Datei daemon.json<\/code> erstellen mit
    sudo nano \/etc\/docker\/daemon.json<\/code>
    und folgende 3 Zeilen copy & pasten oder abtippen:
    {
    \"host\": \"unix:\/\/\/var\/run\/docker.sock\"
    }<\/code>
    \u00c4nderungen im Ubuntu-Texteditor „nano“ speichert man durch dr\u00fccken von Ctrl + X und eintippen von Y gefolgt von ENTER zur Best\u00e4tigung des angezeigten Dateinamens und zur Speicherung der eben gemachten Eingaben.
    (Diese zentrale Konfigurationsdatei erm\u00f6glicht es, verschiedene Einstellungen und Optionen f\u00fcr den Docker-Daemon zu definieren, ohne dass man sie direkt in der Befehlszeile angeben muss.<\/em>
    Die Host-Zeile legt fest, dass Docker \u00fcber den Unix-Socket<\/em> \/var\/run\/docker.sock<\/code> kommunizieren soll, eine effiziente und sichere Methode f\u00fcr die Interaktion zwischen dem Docker-Daemon und den Docker-Clients.)<\/em><\/p>\n\n\n\n

    b) <\/strong>Damit man als Windows-Benutzer nicht vor jedem WSL2-Befehl sudo <\/code>eintippen muss
    (um f\u00fcr den n\u00e4chsten Befehl an h\u00f6here Benutzerrechte zu gelangen):
    sudo usermod -aG docker $USER<\/code>
    (Dieser Befehl f\u00fcgt den aktuell angemeldeten Benutzer zur Gruppe docker<\/code> hinzu.)<\/em>
    \"daemon.json
    -> Diese Gruppenzuteilung wird erst nach dem n\u00e4chsten WSL2-Start aktiv!<\/p>\n\n\n\n

    Dank dem so installierten docker<\/strong> w\u00e4re nun folgendes Gedankenspiel m\u00f6glich:
    Man k\u00f6nnte sich nun einen Ubuntu-docker-Container installieren:
    docker run -it ubuntu bash<\/code>
    Das w\u00e4re dann z.B. Windows 10 mit VMware Workstation -> Windows 11 als virtuelle Maschine -> WSL2 unter Windows 11 -> Ubuntu in WSL2 -> docker in Ubuntu -> Ubuntu als Container.
    Was vermutlich fr\u00fcher oder sp\u00e4ter nicht zur \u00dcbersichtlichkeit und Verst\u00e4ndlichkeit beitr\u00e4gt. .-)<\/p>\n\n\n\n

    Viel n\u00fctzlicher sind nun Container, die man aus dem riesigen Angebot bei https:\/\/hub.docker.com\/<\/a> oder https:\/\/www.linuxserver.io\/our-images<\/a> finden und installieren kann. Ein konkretes Beispiel habe ich hier dokumentiert: https:\/\/ictknow-how.ch\/blog\/2025\/02\/27\/laeuft-musicbrainz-docker-auch-direkt-unter-windows-wsl2-ohne-docker-desktop\/<\/a><\/p>\n\n\n\n

    Mit dem Befehl
    exit<\/code>
    gelangt man aus dem Ubuntu-Container zur\u00fcck in die WSL2-Umgebung.
    Mit einem weiteren
    exit<\/code>
    verl\u00e4sst man dann die WSL2-Umgebung selber und gelangt zur\u00fcck zu Windows.<\/p>\n\n\n\n

    —<\/p>\n\n\n\n

    Zum Abschluss noch ein kleiner Trick<\/strong>. Vermutlich fragt man sich fr\u00fcher oder sp\u00e4ter wo eigentlich diese Daten in der WSL2 auf dem Windows-Rechner gespeichert werden. Dazu kann man in der WSL2 in einem beliebigen Verzeichnis wie z.B. \/self-created-dir$<\/code> den Windows-Explorer mit
    explorer.exe . <\/code>
    starten:\"Windows<\/p>\n\n\n\n

    Der Explorer zeigt in der Adressleiste unter \\\\wsl.localhost<\/code> den kompletten Pfad zum aktuellen Verzeichnis in WSL2 an.

    Man kann sich auch den Inhalt von Verzeichnissen aus dem Host-System anzeigen lassen. Vorausgesetzt WSL2 hat ausreichend Leserechte daf\u00fcr. Ein Beispiel daf\u00fcr w\u00e4re:
    ls \/mnt\/c\/Users\/Public\/*<\/code>\"Zugriff<\/p>\n\n\n\n

    Ich hoffe, dass hilft dem einen oder anderen Leser bei der Installation von docker unter WSL2.
    Bei Fragen helfe ich – so gut wie m\u00f6glich – gerne weiter. Einfach einen Kommentar hinterlassen.<\/p>\n\n\n

    \n \n
    \n \n
    \n
    \n \n\n
    <\/div>\n <\/div>\n
    \n \n\n
    <\/div>\n <\/div>\n
    \n \n\n
    <\/div>\n <\/div>\n
    \n \n\n
    <\/div>\n <\/div>\n
    \n \n\n
    <\/div>\n <\/div>\n <\/div>\n \n
    \n
    \n \n\n
    <\/div>\n <\/div>\n
    \n \n\n
    <\/div>\n <\/div>\n
    \n \n\n
    <\/div>\n <\/div>\n
    \n \n\n
    <\/div>\n <\/div>\n
    \n \n\n
    <\/div>\n <\/div>\n <\/div>\n<\/div>\n \n\n
    \n Rate this post<\/span>\n <\/div>\n <\/div>\n","protected":false},"excerpt":{"rendered":"

    Die meisten kennen vermutlich \u00abDocker Desktop f\u00fcr Windows AMD64\u00bb. Dieses offizielle Installationsprogramm installiert ein sch\u00f6nes GUI. Darum geht es in diesem Artikel nicht! Hier geht es darum, wie man docker in der WSL2-Kommandozeile direkt installiert, ohne GUI, ohne sch\u00f6ne Icons. Folgende Punkte sind zur Installation notwendig: Mit folgenden Befehlen kann man pr\u00fcfen, ob docker in … Weiterlesen<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[264,28,48,245],"tags":[263,39,300],"class_list":["post-3809","post","type-post","status-publish","format-standard","hentry","category-docker","category-software","category-windows-10","category-windows-11","tag-docker","tag-ubuntu","tag-wsl2"],"_links":{"self":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/posts\/3809","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/comments?post=3809"}],"version-history":[{"count":0,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/posts\/3809\/revisions"}],"wp:attachment":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/media?parent=3809"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/categories?post=3809"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/tags?post=3809"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}