Installare Docker Desktop su Windows 11 o 10 con PowerShell

Prerequisiti reali prima di toccare PowerShell

Su Windows 11 l’installazione di Docker Desktop è abbastanza lineare, ma conviene partire dai prerequisiti invece di lanciare l’installer alla cieca. Il punto non è solo far partire Docker, ma farlo partire in modo coerente con WSL 2, virtualizzazione attiva e un profilo utente che non si rompa al primo riavvio.

Docker Desktop su Windows può lavorare con il backend WSL 2 oppure con il vecchio stack Hyper-V. Oggi, nella pratica, WSL 2 è la scelta più sensata per quasi tutti gli scenari di sviluppo locale: meno attrito, integrazione migliore con filesystem Linux e meno conflitti con le edizioni Home. Se il sistema non supporta la virtualizzazione o la feature è disattivata nel BIOS/UEFI, l’installazione può anche completarsi, ma il servizio non funzionerà davvero.

Prima di installare verifica questi punti: Windows 10 22H2 o Windows 11 aggiornato, virtualizzazione hardware abilitata, spazio disco sufficiente, account con privilegi amministrativi e connettività verso i repository Microsoft e Docker. Se lavori in ambienti aziendali filtrati, il blocco più frequente non è il setup ma il download dei componenti o l’accesso al login iniziale.

Verifiche rapide con PowerShell

Apri PowerShell come amministratore e controlla subito lo stato di virtualizzazione e la presenza di WSL. Questi comandi non modificano nulla e ti dicono se vale la pena procedere o se serve prima un intervento sul sistema.

systeminfo | findstr /i "Virtualization Hyper-V Requirements"

Se il risultato mostra che la virtualizzazione è abilitata, sei già a buon punto. Se invece compaiono righe negative o mancanti, il problema è quasi sempre nel BIOS/UEFI oppure in una policy aziendale che disattiva le feature necessarie.

Controlla anche lo stato di WSL:

wsl --status

Su un sistema pronto dovresti vedere una distribuzione predefinita o almeno informazioni sul kernel WSL. Se il comando non è riconosciuto, probabilmente la versione di Windows è troppo vecchia oppure il sottosistema non è installato.

Per verificare le feature richieste puoi usare anche questo comando, utile quando vuoi capire se il sistema è già predisposto o se manca qualcosa prima dell’installazione di Docker Desktop:

Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux,VirtualMachinePlatform,Microsoft-Hyper-V-All

Lo stato desiderato è Enabled per WSL e Virtual Machine Platform. Hyper-V non è obbligatorio in tutti gli scenari, ma se vuoi usare il backend classico o se la tua edizione lo richiede, conviene verificarlo prima.

Installare i componenti base con PowerShell

La strada più pulita è abilitare le feature richieste, riavviare e solo dopo installare Docker Desktop. Questo evita metà dei problemi che si vedono quando si prova a fare tutto in un colpo solo.

Da PowerShell amministrativo esegui:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart

Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart

Se il tuo scenario richiede Hyper-V, aggiungilo solo se necessario:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All -NoRestart

Quando hai abilitato le feature, riavvia il sistema. Il riavvio non è un dettaglio: senza, WSL 2 e la piattaforma di virtualizzazione spesso risultano ancora parzialmente inattivi.

Dopo il reboot, aggiorna WSL al ramo più recente se disponibile:

wsl --update

Se il comando restituisce errore, non forzare oltre: significa che la build di Windows o la connettività al canale di aggiornamento non è allineata. In quel caso conviene verificare la versione di Windows con winver e la presenza dell’aggiornamento richiesto.

Installare Docker Desktop in modo ripetibile

Docker Desktop può essere installato con l’installer grafico, ma se il tuo obiettivo è avere una procedura ripetibile, PowerShell è preferibile. Il punto è scaricare il pacchetto ufficiale, verificarlo e poi lanciare l’installazione con privilegi amministrativi.

Un flusso pratico è questo: scarichi l’installer dal sito ufficiale Docker, lo salvi in una cartella nota e poi lo esegui da PowerShell. Se vuoi automatizzare, puoi usare Start-Process per lanciare l’eseguibile con i parametri corretti.

Start-Process -FilePath "C:	emp" -ArgumentList "Docker Desktop Installer.exe install" -Wait -Verb RunAs

Il percorso va adattato al nome reale del file scaricato. Se preferisci controllare prima il contenuto della cartella, usa:

Get-ChildItem C:	emp

Se l’installer è stato scaricato da browser o da repository aziendale, verifica anche che il file non sia stato bloccato da Windows:

Get-Item "C:	emp	runcated?"

In pratica, il controllo utile è sul file reale e sulla sua provenienza. Se il pacchetto è stato alterato o incompleto, non andare avanti: riscaricalo dal canale ufficiale.

Primo avvio e configurazione del backend

Al primo avvio Docker Desktop ti chiederà di scegliere il backend. Per quasi tutti i casi moderni conviene usare WSL 2. Se l’app propone Hyper-V come default, non è un errore, ma spesso non è la scelta più efficiente su Windows 10 Home o su macchine da sviluppo che devono restare snelle.

Dopo l’installazione apri Docker Desktop e verifica nelle impostazioni che l’opzione Use the WSL 2 based engine sia attiva. Se hai più distribuzioni Linux installate, puoi anche abilitare l’integrazione solo su quelle che ti servono. Questo riduce rumore e tempi di startup.

Se Docker Desktop non si avvia o resta bloccato su Starting, le cause più frequenti sono tre: WSL non aggiornato, virtualizzazione disattivata nel firmware, oppure un conflitto con software di sicurezza che intercetta i driver virtuali. In ambienti aziendali vale la pena controllare anche eventuali policy che bloccano il componente com.docker.service.

Verifiche finali che contano davvero

Non fermarti all’icona verde nella tray. La verifica vera è eseguire un container di test e controllare che il motore risponda correttamente.

docker version

Se ottieni la versione client e server, il daemon è operativo. A quel punto prova un container minimale:

docker run --rm hello-world

Il risultato atteso è un messaggio di conferma che indica che Docker ha scaricato l’immagine e avviato il container correttamente. Se il comando fallisce, il problema può essere nella rete, nel backend WSL, o nella configurazione dell’engine.

Controlla anche lo stato delle distribuzioni WSL usate da Docker:

wsl -l -v

Le distribuzioni di Docker dovrebbero risultare presenti e in versione 2. Se compaiono in versione 1, qualcosa non ha completato la migrazione e conviene correggerlo prima di andare avanti.

Problemi tipici su Windows 10 e come leggerli senza perdere tempo

Su Windows 10 i punti deboli sono più spesso legati all’edizione e alla build installata. Windows 10 Home può usare WSL 2 senza problemi, ma non ha Hyper-V completo come le edizioni Pro o Enterprise. Questo non è un limite pratico per Docker Desktop se il backend WSL 2 è disponibile e configurato bene.

Se il problema è il login iniziale di Docker Desktop, spesso non è un bug dell’app ma un blocco di rete verso i servizi di autenticazione. In quel caso puoi verificare proxy, DNS e firewall prima di cercare colpe nel sistema locale. Se il problema invece è che il comando docker non è nel PATH, chiudi e riapri la shell oppure verifica che l’installazione sia andata a buon fine.

Quando il sistema è aziendale e gestito, la diagnosi utile è sempre la stessa: confronta lo stato atteso con quello osservato. Atteso: WSL 2 attivo, virtualizzazione abilitata, Docker Desktop avviato, docker run --rm hello-world funzionante. Osservato: dove si ferma la catena tra installazione, avvio, login e run del container.

Ripristino rapido e rollback se qualcosa va storto

Se l’installazione ha introdotto problemi, il rollback deve essere semplice e reversibile. Prima chiudi Docker Desktop, poi disinstalla l’app da Impostazioni > App oppure dal pannello classico, e infine valuta se disabilitare le feature Windows che hai attivato solo per il test.

Per rimuovere le feature abilitate via PowerShell puoi tornare indietro con:

Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux -NoRestart

Disable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart

Se avevi abilitato Hyper-V solo per questa macchina, disattivalo solo dopo aver verificato che non serva ad altri software locali. Il blast radius qui è medio: tocchi il layer di virtualizzazione del sistema, quindi il rollback va fatto con criterio e non in orari in cui servono altri ambienti di test.

Assunzione: il lettore ha privilegi amministrativi, una build di Windows compatibile e vuole installare Docker Desktop con backend WSL 2 come scelta predefinita.