Build

ERROR: no match for platform in manifest: requested linux/arm64 but image only has linux/amd64. – Docker PLATFORM_MISMATCH

PLATFORM_MISMATCH

Si verifica su macchine Apple Silicon (ARM64) o Raspberry Pi quando l'immagine richiesta nel comando `FROM` è disponibile sul registry unicamente per architettura x86_64/AMD64.

Categoria: DockerGruppo: BuildConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 1 volta

Cosa significa questo errore?

Si verifica su macchine Apple Silicon (ARM64) o Raspberry Pi quando l'immagine richiesta nel comando `FROM` è disponibile sul registry unicamente per architettura x86_64/AMD64.

Messaggio originale

ERROR: no match for platform in manifest: requested linux/arm64 but image only has linux/amd64.

Contesto e parole chiave

Alias

  • no match for platform in manifest
  • platform mismatch Docker

Messaggi alternativi

  • nessuna corrispondenza per la piattaforma nel manifesto dell'immagine

Prodotti

  • Docker Engine / Docker Compose / BuildKit / containerd

Piattaforme

  • Docker Desktop su macOS
  • Docker Desktop su Windows
  • Linux

Parole chiave

  • Build
  • compose
  • container
  • docker
  • docker.build.platform-mismatch-manifest
  • errore-docker-platform-mismatch-manifest
  • PLATFORM_MISMATCH

Cause possibili

Origine del problema per Docker: nessuna immagine compatibile con la piattaforma richiesta

Si verifica su macchine Apple Silicon (ARM64) o Raspberry Pi quando l'immagine richiesta nel comando `FROM` è disponibile sul registry unicamente per architettura x86_64/AMD64.

molto comune

Diagnosi

Diagnostica container e log per Docker: nessuna immagine compatibile con la piattaforma richiesta

Eseguire comandi di ispezione dei container e controllare i log del demone Docker con journalctl o docker logs.

Come leggere il risultato. Mostra le eccezioni a runtime dell'applicazione, segnali di terminazione o errori di rete interna.

docker
docker logs --tail 50 <container_id>

Risoluzione

Procedura di risoluzione per Docker: nessuna immagine compatibile con la piattaforma richiesta

Difficoltà: mediaRischio: basso

Applicare la configurazione raccomandata nelle specifiche ufficiali Docker e BuildKit.

  1. Ispezionare i parametri di avvio nel file Dockerfile o docker-compose.yml
  2. Verificare i vincoli di memoria, permessi e compatibilità delle porte
  3. Riavviare il container o eseguire una compilazione pulita senza cache

Domande frequenti

Come risolvere il problema PLATFORM_MISMATCH in Docker?

Si verifica su macchine Apple Silicon (ARM64) o Raspberry Pi quando l'immagine richiesta nel comando `FROM` è disponibile sul registry unicamente per architettura x86_64/AMD64.

Approfondimenti

Schede correlate