Guida passo-passo: Installazione di Docker Desktop su Windows e macOS

Inizia con Docker installando Docker Desktop su Windows e macOS. Questa guida passo-passo copre i prerequisiti, le istruzioni per il download, le procedure di installazione e i passaggi di verifica iniziali per entrambi i sistemi operativi. Impara a configurare il tuo ambiente di sviluppo per una containerizzazione efficiente.

Guida Passo-Passo: Installazione di Docker Desktop su Windows e macOS

Docker Desktop è il punto di partenza usuale quando si vogliono eseguire container su un laptop Windows o macOS. L'installazione è semplice, ma alcune impostazioni di sistema possono impedire a Docker di avviarsi dopo il completamento dell'installer.

Questa guida ti accompagna attraverso l'installazione di Docker Desktop su Windows e macOS, quindi verifica che la CLI di Docker, il Docker Engine e un container di test funzionino correttamente.

Cosa Installa Docker Desktop

Docker Desktop ti fornisce un ambiente Docker locale con la CLI di Docker, il Docker Engine, Docker Compose, un dashboard desktop e il supporto opzionale per Kubernetes. Su Windows, Docker Desktop esegue normalmente container Linux tramite WSL 2. Su macOS, esegue container all'interno di una macchina virtuale Linux leggera.

Per lo sviluppo quotidiano, ciò significa che puoi eseguire comandi come:

docker run hello-world
docker compose up
docker build -t my-app .

Non è necessario installare prima un pacchetto Docker Engine separato.

Verifica Prima i Requisiti

Docker cambia i requisiti di piattaforma nel tempo, quindi controlla la documentazione corrente di Docker prima di installare su macchine più vecchie. Nella maggior parte delle configurazioni attuali, dovresti confermare questi elementi di base.

Requisiti per Windows

Usa un'edizione di Windows a 64 bit supportata e mantieni Windows aggiornato. Docker Desktop funziona meglio con il backend WSL 2, quindi installa WSL prima o durante la configurazione:

wsl --install

Esegui quel comando da un PowerShell o Prompt dei comandi elevato, quindi riavvia se Windows te lo chiede.

Controlla anche la virtualizzazione hardware. Apri Task Manager, vai su Prestazioni, seleziona CPU e cerca Virtualizzazione: Abilitata. Se è disabilitata, attivala nelle impostazioni del BIOS o UEFI.

Docker Desktop è per ambienti desktop Windows, non per Windows Server.

Requisiti per macOS

Usa una versione di macOS supportata su Apple silicon o un Mac Intel. Scarica l'installer corretto per il tuo tipo di chip. Se non sei sicuro di quale Mac hai, apri Menu Apple > Informazioni su questo Mac e controlla la riga del chip o del processore.

Docker Desktop necessita di memoria e spazio su disco sufficienti per eseguire una VM Linux e memorizzare le immagini. Se prevedi di eseguire database o stack multi-servizio localmente, dai a Docker più memoria nelle impostazioni dopo l'installazione.

Installa Docker Desktop su Windows

Scarica Docker Desktop dal sito ufficiale di Docker. Evita mirror di download di terze parti per strumenti di sviluppo.

Esegui l'installer .exe e mantieni abilitata l'opzione WSL 2 quando appare. Se l'installer offre di aggiungere componenti Windows richiesti, permettilo. Dopo l'installazione, riavvia il computer se richiesto.

Apri Docker Desktop dal menu Start. Al primo avvio, accetta i termini di licenza e lascia che Docker completi la sua configurazione. Se Docker segnala un problema con WSL, aggiorna WSL e riprova:

wsl --update

Se usi un laptop aziendale, il software di sicurezza degli endpoint può interferire con la virtualizzazione o la rete locale. In tal caso, controlla la politica aziendale su Docker Desktop prima di modificare le impostazioni del firewall o dell'antivirus.

Installa Docker Desktop su macOS

Scarica Docker Desktop per Mac dal sito ufficiale di Docker. Scegli l'installer per Apple silicon per i Mac con chip M-series e l'installer per Intel per i Mac Intel.

Apri il file .dmg, quindi trascina Docker nella cartella Applicazioni. Avvia Docker da Applicazioni. macOS potrebbe chiedere la tua password o il permesso per installare componenti helper utilizzati per la rete e la virtualizzazione.

Quando Docker Desktop si avvia, attendi fino a quando l'icona nella barra dei menu mostra che Docker è in esecuzione. Il primo avvio può richiedere più tempo perché Docker crea la sua VM locale e lo storage.

Verifica l'Installazione

Apri un terminale e controlla il client e il server Docker:

docker version

Dovresti vedere sia una sezione client che una sezione server. Se vedi solo informazioni sul client o un errore sulla connessione al demone, Docker Desktop non è ancora in esecuzione o non è riuscito ad avviarsi.

Esegui il container di test standard:

docker run hello-world

Docker scarica una piccola immagine e la esegue. Un'esecuzione riuscita stampa un messaggio che spiega che Docker funziona.

Puoi anche controllare Docker Compose:

docker compose version

Usa il comando docker compose separato da spazio per Compose v2, che è incluso con Docker Desktop.

Regola le Prime Impostazioni

Apri le impostazioni di Docker Desktop dopo il primo test riuscito.

Su Windows, controlla Risorse > Integrazione WSL e abilita l'integrazione per le distribuzioni Linux in cui esegui comandi di sviluppo. Se usi Ubuntu in WSL, questo ti permette di eseguire docker dalla shell di Ubuntu.

Sia su Windows che su macOS, rivedi Risorse. I progetti piccoli possono funzionare bene con le impostazioni predefinite, ma Kubernetes locale, database e build grandi spesso necessitano di più memoria o spazio su disco.

Abilita Kubernetes solo se hai bisogno di un cluster a singolo nodo locale. Lasciarlo disattivato mantiene Docker Desktop più leggero.

Problemi Comuni di Installazione

Se Docker non si avvia su Windows, prima conferma che la virtualizzazione sia abilitata e WSL sia installato:

wsl --status

Se WSL è obsoleto, esegui:

wsl --update

Se docker version non riesce a connettersi al demone Docker, assicurati che Docker Desktop sia in esecuzione e abbia completato l'avvio. Su macOS, controlla l'icona nella barra dei menu. Su Windows, controlla l'area di notifica.

Se un container di test non riesce a raggiungere la rete, prova da una rete diversa o da uno stato VPN diverso. I client VPN e i proxy aziendali spesso influenzano la rete di Docker. Docker Desktop ha impostazioni proxy che puoi configurare quando il tuo ambiente lo richiede.

Una volta che docker run hello-world funziona, il tuo ambiente container locale è pronto. Un buon passo successivo è eseguire un servizio che già conosci, come Nginx:

docker run --rm -p 8080:80 nginx

Poi apri http://localhost:8080. Se vedi la pagina di benvenuto di Nginx, Docker può scaricare immagini, avviare container e pubblicare porte sulla tua macchina.