Docker Install on WSL 2 - First Container Setup

Kontrollera din PC först

Docker Desktop med WSL 2-backend behöver tre saker, och att hoppa över denna tvåminuterskontroll är hur folk förlorar en kväll. Först, Windows-versionen: du behöver Windows 10 version 2004 eller senare, eller Windows 11. Tryck på Win + R, skriv winver och tryck på Retur för att se din exakta version.

winver

För det andra måste virtualisering vara påslagen i BIOS eller UEFI. Öppna Aktivitetshanteraren, gå till Prestanda, sedan CPU och leta efter Virtualisering: Aktiverad. Om det står Disabled kommer ingen programvaruinställning att rädda dig - aktivera Intel VT-x eller AMD SVM i BIOS först. För det tredje, behåll cirka 4 GB ledigt RAM-minne och några GB reservdelar: WSL 2 och Docker delar din maskin, de ersätter den inte.

Installera WSL 2 före något annat

De flesta misslyckade Docker-installationer på Windows misslyckas av en tråkig anledning: ordern var fel. Docker Desktop förväntar sig en fungerande WSL 2 under den, så bygg grunden först. Öppna PowerShell som administratör och kör ett kommando:

wsl --install

Låt det avslutas och starta sedan om datorn — omstarten är inte valfri, den laddar virtualiseringskomponenterna. Efter omstarten slutför Ubuntu (standarddistro) sin egen installation och ber dig skapa ett Linux-användarnamn och lösenord.

Kontrollera att WSL 2 verkligen är redo

Innan Docker går någonstans nära maskinen, bekräfta grunden med två kommandon:

wsl --status
wsl -l -v

Din distro bör visa VERSION 2 i listan. Om den visar 1, ställ in standardversionen och konvertera distron som kommandoutgången föreslår:

wsl --set-default-version 2

Varje lager testas innan nästa går vidare, så om något misslyckas senare vet du exakt vilket lager som äger problemet.

Installera Docker Desktop på toppen

Ladda ner Docker Desktop endast från docker.com - tredjeparts nedladdningssidor paketerar skräp med populära installationsprogram. Kör installationsprogrammet och håll alternativet Använd WSL 2 istället för Hyper-V markerat; på de flesta datorer är det markerat som standard.

När installationsprogrammet frågar, låt det stänga och logga ut dig eller starta om om du uppmanas. Docker lägger till ditt Windows-konto i den lokala docker-användare-gruppen, och gruppmedlemskap träder bara i kraft vid en ny inloggning – detta är den ärliga kontroll som de flesta guider hoppar över, och det är därför Docker ibland vägrar att starta förrän du loggar ut och in igen.

Starta Docker Desktop och vänta tills valikonen i systemfältet har lagt sig och instrumentpanelen rapporterar att Motorn är igång. Den första starten är långsam; ge det ett par minuter. Acceptera skärmen för Docker-abonnemangstjänstavtal ärligt – det är en riktig licens.

Kör din första container — Hello World

Öppna ett nytt PowerShell- eller Terminal-fönster och kör de två kommandona som bevisar att hela kedjan fungerar:

docker --version
docker run hello-world

docker --version bevisar att klienten är installerad och på din PATH. docker run hello-world bevisar allt annat: Docker kan inte hitta bilden lokalt, laddar ner den från Docker Hub, skapar en container från den, kör den och skriver ut dess Hej från Docker!-meddelande. Om det meddelandet visas fungerar din kedja från början - terminal, klient, motor inuti WSL 2, nätverk och register.