{"slug": "como-solucionar-docker-run-con-exit-code-1-en-raspberry-pi", "title": "Cómo solucionar `docker run` con exit code 1 en Raspberry Pi", "summary": "The article explains that a `docker run` command resulting in exit code 1 on a physical Raspberry Pi is often caused by an architecture mismatch (e.g., running an amd64 image on an ARM system) or a syntax error in the command, such as spaces around the `=` in `--net = host`. It recommends verifying the architecture with `uname -m` and `docker inspect`, installing QEMU for multi-architecture support, and using `docker buildx` to build images specifically for ARM platforms to prevent the error.", "body_md": "docker run\ncon exit code 1 en Raspberry Pi\nEl error Exited (1)\nindica que el proceso principal del contenedor terminó con un código de salida no cero —es decir, falló. El hecho de que funcione en una VM de Raspberry Pi pero no en el hardware físico apunta a una diferencia en el entorno de ejecución. Las causas más comunes en Raspberry Pi son:\namd64\n(x86_64) y se intenta ejecutar en ARM (armv7l\no aarch64\n).binfmt_misc\nconfigurado, Docker no puede ejecutar binarios de otra arquitectura.docker run\n: El espacio en --net = host\n(con espacios alrededor del =\n) es un error de sintaxis que no siempre es detectado por Docker, pero puede causar comportamientos erráticos.# Arquitectura del Raspberry Pi (hardware físico)\nuname -m\n# Arquitectura de la imagen\ndocker inspect myimage --format '{{.Architecture}}'\nSi uname -m\nmuestra armv7l\no aarch64\n, y la imagen reporta amd64\n, la arquitectura no coincide.\ndocker run\nEl comando original tiene un error grave: --net = host\n(espacios alrededor del =\n). Docker interpreta =\ncomo parte del valor del flag, lo que puede causar fallos silenciosos o errores de parseo.\n✅ Comando corregido:\ndocker run --net=host -d -t myimage\n⚠️ Nota crítica: En versiones recientes de Docker,\n--net=host\nno funciona en contenedores no Linux (como en Raspberry Pi conarmhf\n), y puede causar fallos si el kernel no lo soporta. Si el contenedor no necesita acceso directo a la red del host, usa--net=bridge\n.\ndocker run --net=host -it --rm myimage\nElimina\n-d\n(background) y añade-it\npara ver logs en tiempo real y capturar errores.\nInstala soporte multiarquitectura:\n# Instala binfmt-support y QEMU\nsudo apt update && sudo apt install -y qemu-user-static binfmt-support\n# Registra los binarios QEMU para Docker\ndocker run --rm --privileged multiarch/qemu-user-static --reset -p yes\nLuego ejecuta de nuevo tu contenedor.\ndocker ps -a # Encuentra el ID del contenedor con Exited (1)\ndocker logs <container_id>\n# Paso 1: Verifica arquitectura\nuname -m\ndocker inspect myimage --format '{{.Architecture}}'\n# Paso 2: Corrige sintaxis y ejecuta en primer plano\ndocker run --net=host -it --rm myimage\n# Paso 3 (si falla por arquitectura): Instala QEMU\nsudo apt update && sudo apt install -y qemu-user-static binfmt-support\ndocker run --rm --privileged multiarch/qemu-user-static --reset -p yes\n# Paso 4: Reintenta\ndocker run --net=host -d -t myimage\nSi controlas la construcción de la imagen, nunca uses imágenes amd64\nen Raspberry Pi. Usa:\n# En el Dockerfile, especifica plataforma explícitamente\nFROM --platform=linux/arm/v7 raspbian/stretch\n# O para Raspberry Pi 4 (64-bit)\nFROM --platform=linux/arm64 ubuntu:22.04\nY construye con:\ndocker build --platform linux/arm/v7 -t myimage .\n✅ Consejo definitivo: Usa\ndocker buildx\npara construir multiarquitectura:\ndocker buildx build --platform linux/arm/v7,linux/arm64 -t myimage .\nEsto evita 99% de los errores de Exited (1)\nen Raspberry Pi.\nSi te sirvió esta ayuda, suscríbete para recibir los errores más comunes de la semana y cómo evitarlos.\n👉 Suscríbete aquí", "url": "https://wpnews.pro/news/como-solucionar-docker-run-con-exit-code-1-en-raspberry-pi", "canonical_source": "https://dev.to/erickeduardoramos03/como-solucionar-docker-run-con-exit-code-1-en-raspberry-pi-5cap", "published_at": "2026-05-23 17:21:22+00:00", "updated_at": "2026-05-23 17:33:15.088370+00:00", "lang": "en", "topics": ["developer-tools", "hardware"], "entities": ["Docker", "Raspberry Pi"], "alternates": {"html": "https://wpnews.pro/news/como-solucionar-docker-run-con-exit-code-1-en-raspberry-pi", "markdown": "https://wpnews.pro/news/como-solucionar-docker-run-con-exit-code-1-en-raspberry-pi.md", "text": "https://wpnews.pro/news/como-solucionar-docker-run-con-exit-code-1-en-raspberry-pi.txt", "jsonld": "https://wpnews.pro/news/como-solucionar-docker-run-con-exit-code-1-en-raspberry-pi.jsonld"}}