DEV Community: Erick Eduardo Ramos

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

Erick Eduardo Ramos — Mon, 21 Sep 2026 15:33:11 +0000

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

¿Por qué ocurre este error?

El código de salida 1 indica que el proceso principal del contenedor terminó con un error genérico. En Raspberry Pi, los casos más comunes son:

Arquitectura incompatible: La imagen fue construida para amd64 (x86_64), pero Raspberry Pi usa arm32v7 o arm64v8.
Falta de binarios compatibles: El ENTRYPOINT o CMD de la imagen intenta ejecutar un binario compilado para otra arquitectura.
Problemas de permisos o dependencias faltantes en el entorno de Raspberry Pi.
Uso incorrecto de --net=host: En algunos sistemas antiguos de Docker en Raspberry Pi, esta opción causa fallos silenciosos si no se usa correctamente.

🔍 Nota crítica: En tu comando docker run --net = host -d -t myimage, hay un error de sintaxis: --net = host tiene espacios alrededor del =. Docker lo interpreta como un nombre de red literal " host", lo que puede causar fallos silenciosos o comportamientos inesperados.

Pasos para solucionarlo

Paso 1: Corrige la sintaxis del comando

Elimina los espacios alrededor del = en --net=host:

docker run --net=host -d -t myimage

Paso 2: Verifica la arquitectura de la imagen

Ejecuta en tu Raspberry Pi:

docker inspect myimage --format '{{.Architecture}}'

Si muestra amd64, no es compatible con Raspberry Pi (a menos que uses QEMU emulación).
Debería mostrar arm o arm64.

Paso 3: Construye o descarga una imagen compatible

Si la imagen es tuya, reconstrúyela para ARM:

# En Raspberry Pi (o con Docker Buildx)
docker build --platform linux/arm/v7 -t myimage-arm .

O descarga una versión oficial compatible (ej. arm32v7/python:3.9, arm64v8/nginx, etc.).

Paso 4: Ejecuta en primer plano para depurar

Reemplaza -d (detached) por -it para ver el error en tiempo real:

docker run --net=host -it myimage

Esto mostrará el mensaje de error real (ej. exec format error, segmentation fault, command not found, etc.).

Paso 5: Verifica logs si el contenedor ya se ejecutó

docker logs <container_id>
# O desde el ID obtenido con `docker ps -a`

Bloque de código corregido (ejemplo funcional)

# 1. Verifica la arquitectura de tu Raspberry Pi
uname -m  # Debería mostrar 'armv7l' o 'aarch64'

# 2. Asegura que la imagen sea compatible
docker pull arm32v7/alpine:latest  # Ejemplo de imagen ARM válida

# 3. Ejecuta con sintaxis correcta y en primer plano para depurar
docker run --net=host -it arm32v7/alpine:latest sh

# 4. Si necesitas construir tu propia imagen:
# En Dockerfile:
FROM arm32v7/python:3.9-slim
# ... resto del Dockerfile

Pro-tip: Usa `docker buildx` para multiarquitectura

Si necesitas mantener compatibilidad con múltiples plataformas:

# Crea un builder con soporte multiplataforma
docker buildx create --use

# Construye e impulsa para múltiples arquitecturas
docker buildx build \
  --platform linux/arm/v7,linux/amd64 \
  -t myimage:latest \
  --push \
  .

Esto genera automáticamente imágenes nativas para cada arquitectura, evitando errores de exec format error.

✅ Resultado esperado: El contenedor se ejecuta sin salir con código 1, y puedes depurar cualquier otro error específico con los logs en primer plano.

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

Erick Eduardo Ramos — Sun, 20 Sep 2026 13:23:16 +0000

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

¿Por qué ocurre?

El error Exited (1) indica que el proceso principal del contenedor terminó con un código de error (1 = error genérico). En Raspberry Pi, los casos más comunes son:

Arquitectura incompatible: La imagen se construyó para amd64 (x86_64), pero Raspberry Pi usa arm32v7 o arm64v8.
Falta de binarios compatibles: El ENTRYPOINT/CMD de la imagen no existe o no es ejecutable en ARM.
Problemas de permisos o dependencias faltantes (especialmente en entornos minimalistas como Raspbian).
Uso incorrecto de --net=host: En versiones antiguas de Docker en Raspberry Pi, este flag puede causar fallos si no se configura correctamente.

🔍 Nota crítica: En tu comando hay un error tipográfico: --net = host (con espacios alrededor del =). Docker lo interpreta como un nombre de red literal " host", lo que puede causar fallos silenciosos o errores posteriores.

Pasos para solucionarlo

1. Verifica el código de error real

docker run --rm --net=host -t myimage

❗ Quita -d para ver los logs en tiempo real y detectar el fallo inmediato.

2. Confirma la arquitectura de tu imagen

docker inspect myimage --format '{{.Architecture}}'

Si muestra amd64, no es compatible con Raspberry Pi.
Para Raspberry Pi 3/4 (32-bit): necesitas armv7l (o arm32v7).
Para Raspberry Pi 4 (64-bit): necesitas arm64 (o arm64v8).

3. Construye la imagen para ARM (si no tienes una versión compatible)

# Opción A: Usar Docker Buildx (recomendado)
docker buildx create --use
docker buildx build --platform linux/arm/v7 -t myimage:armv7 . --push

# Opción B: Para Raspberry Pi 4 (64-bit)
docker buildx build --platform linux/arm64 -t myimage:arm64 . --push

4. Usa el flag `--net=host` correctamente (sin espacios)

docker run --net=host -d -t myimage

5. Verifica el contenedor en primer plano para debug

docker run --rm --net=host -it --entrypoint=/bin/sh myimage
# Luego ejecuta manualmente el comando que falla

Bloque de código corregido (ejemplo funcional)

# Paso 1: Verificar arquitectura del host
uname -m

# Paso 2: Si la imagen es incompatible, reconstruir para ARM
docker buildx build --platform linux/arm/v7 -t myimage:armv7 .

# Paso 3: Ejecutar con sintaxis correcta
docker run --rm --net=host -d myimage:armv7

⚠️ Importante: Si usas una imagen de Docker Hub, busca variantes con sufijo arm32v7, arm64v8, o multiarch. Ejemplo: arm32v7/nginx en lugar de nginx.

Pro-tip: Diagnóstico rápido con `docker events`

# En una terminal, ejecuta:
docker events --filter event=die

# En otra, ejecuta tu contenedor:
docker run --net=host -d myimage

# Verás en tiempo real:
# die (exitCode=1, image=myimage, ...)

Esto te dará el código exacto de salida sin necesidad de depurar manualmente.

✅ Solución definitiva:

Construye tu imagen para la arquitectura correcta de ARM y corrige la sintaxis de --net=host (sin espacios). El 90% de los casos Exited (1) en Raspberry Pi se resuelven así.

Cómo solucionar `Code exited (1)` en Docker en Raspberry Pi

Erick Eduardo Ramos — Sat, 19 Sep 2026 12:48:48 +0000

Cómo solucionar `Code exited (1)` en Docker en Raspberry Pi

Explicación técnica

El error Exited (1) indica que el proceso principal (PID 1) del contenedor terminó con un código de salida distinto de cero —en este caso, 1, que es un código genérico de error. En Raspberry Pi, este problema es especialmente común cuando se ejecutan contenedores construidos para arquitecturas x86/x64 en una máquina ARM (como la Raspberry Pi), o cuando hay incompatibilidades en la imagen (por ejemplo, dependencias binarias no compatibles con el entorno de ejecución).

En tu caso, el hecho de que funcione en una VM (probablemente x86_64) pero no en la Raspberry Pi física es una pista crítica: tu imagen no es compatible con la arquitectura ARM de la Raspberry Pi.

Otras causas comunes:

Falta de permisos o dispositivos (/dev/mem, /dev/gpiomem, etc.).
Incompatibilidad de librerías (libc, libstdc++, etc.) entre entornos.
Error en el ENTRYPOINT o CMD del Dockerfile (por ejemplo, ejecutar un binario x86 en ARM).
Variables de entorno faltantes o incorrectas.

Pasos para solucionarlo

✅ Paso 1: Verifica la arquitectura de tu imagen y del host

# En tu Raspberry Pi:
uname -m
# Debería mostrar: armv7l (Raspberry Pi 3/4) o aarch64 (Raspberry Pi 4/5 con 64-bit OS)

docker images | grep myimage
# Si no ves "arm" o "aarch64" en la etiqueta, es probable que la imagen sea x86_64

✅ Paso 2: Ejecuta el contenedor en primer plano para ver el error real

docker run --net=host -it --rm myimage
# NOTA: Quita `-d` y `-t`, y añade `-i` para interactividad

⚠️ Si ves errores como Illegal instruction, cannot execute binary file, o Exec format error, confirma que es un problema de arquitectura.

✅ Paso 3: Construye la imagen para ARM (solución definitiva)

Opción A: Usa `buildx` para construir multi-arch (recomendado)

# Habilitar buildx
docker buildx create --use

# Construir e impulsar imagen multi-arch (x86 + arm32v7 / arm64v8)
docker buildx build \
  --platform linux/arm/v7,linux/arm64 \
  -t myimage:latest \
  --push \
  .

Si tu imagen es simple (ej. basada en alpine, debian, etc.), asegúrate de usar imágenes base compatibles con ARM:
FROM arm32v7/ubuntu:20.04   # o
FROM arm64v8/ubuntu:20.04

Opción B: Si ya tienes la imagen x86 y no puedes reconstruirla

# Instalar QEMU y binfmt para emulación (lento, pero funcional)
sudo apt update && sudo apt install -y qemu-user-static binfmt-support

# Registra el binfmt handler
docker run --rm --privileged multiarch/qemu-user-static --reset -p yes

# Ahora puedes ejecutar:
docker run --net=host -d -t myimage

⚠️ Nota: La emulación QEMU es 10–100x más lenta y puede fallar con instrucciones específicas del hardware (como acceso a GPIO, GPU, etc.).

Bloque de código corregido (ejemplo práctico)

Dockerfile para Raspberry Pi 3/4 (32-bit)

FROM arm32v7/debian:bullseye-slim

RUN apt-get update && apt-get install -y \
    your-dependencies \
    && rm -rf /var/lib/apt/lists/*

COPY your-binary /app/
WORKDIR /app

# Asegúrate de que el binario sea ARM-compatible
CMD ["./your-binary"]

Comando de ejecución corregido (sin espacios en `--net`)

docker run --net=host -d -t myimage
# ❌ NO: --net = host  (espacios rompen el flag)
# ✅ SÍ: --net=host

🔥 ¡Cuidado con los espacios! En tu comando original: --net = host es inválido. Docker lo interpreta como --net con valor " = host" → falla silenciosamente o crea un error de red.

Pro-tip: Diagnóstico rápido con `strace`

Si necesitas ver exactamente dónde falla el proceso:

# Construye una imagen con strace incluido (o usa una imagen base que lo tenga)
FROM arm32v7/debian:bullseye-slim
RUN apt-get update && apt-get install -y strace

COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

ENTRYPOINT ["strace", "-f", "-o", "/tmp/strace.log", "/entrypoint.sh"]

Luego ejecuta y recupera el log:

docker run --net=host -d -t myimage
docker cp <container_id>:/tmp/strace.log ./strace.log

✅ Resumen final:

Quita los espacios en --net=host.
Verifica arquitectura (uname -m vs docker images).
Usa buildx para construir imágenes nativas ARM.
Usa QEMU solo como solución temporal.

¿Tu imagen usa acceso a hardware (GPIO, I2C, etc.)? Si es así, añade --privileged o monta los dispositivos explícitamente (--device /dev/gpiomem).

Cómo solucionar \"Text content does not match server-rendered HTML\" en Next.js App Router

Erick Eduardo Ramos — Fri, 18 Sep 2026 13:18:14 +0000

Cómo solucionar "Text content does not match server-rendered HTML" en Next.js App Router

Este error ocurre cuando el HTML generado por el servidor (SSR/SSG) no coincide con el árbol de React generado durante la primera renderización en el navegador (hydration). Es un problema crítico de consistencia de estado que rompe la experiencia de usuario y puede causar comportamientos impredecibles.

Causa raíz

En tu caso, el problema es casi seguro causado por el uso de APIs del lado del cliente (window, localStorage, Date.now(), etc.) durante la renderización inicial, o por modificaciones no deterministas del DOM antes de la hidratación (como detecta iOS números telefónicos y los convierte en <a>).

Solución definitiva (pasos verificados)

✅ Paso 1: Identifica la fuente del mismatch

Busca en tus componentes:

new Date() o Date.now() en el render
typeof window !== 'undefined' fuera de useEffect
localStorage.getItem() o sessionStorage en render
<time>, <date>, o contenido dinámico sin suppressHydrationWarning
CSS-in-JS mal configurado (ver Pro-tip abajo)

✅ Paso 2: Aplica la solución correcta según el caso

Caso A: Contenido dinámico (fechas, IDs, tokens)

Usa suppressHydrationWarning solo en el elemento específico:

// ✅ CORRECTO: Solo en el elemento problemático
<time 
  dateTime={new Date().toISOString()} 
  suppressHydrationWarning
>
  {new Date().toLocaleDateString()}
</time>

⚠️ Importante: suppressHydrationWarning no debe usarse en contenedores padres. Solo en elementos de texto que sabes que variarán.

Caso B: Lógica condicional basada en cliente/servidor

Usa useEffect para postergar la renderización:

// ✅ CORRECTO: Renderiza placeholder en SSR
import { useState, useEffect } from 'react';

export default function ClientOnlyComponent() {
  const [mounted, setMounted] = useState(false);

  useEffect(() => {
    setMounted(true);
  }, []);

  if (!mounted) return null; // O un skeleton loading

  return (
    <div>
      {/* Aquí puedes usar window, localStorage, etc. */}
      <span>Token: {localStorage.getItem('token')}</span>
    </div>
  );
}

Caso C: Componentes que dependen de APIs del navegador

Desactiva SSR explícitamente:

// pages/client-only.tsx
import dynamic from 'next/dynamic';

const ClientOnly = dynamic(
  () => import('../components/ClientOnly'),
  { ssr: false }
);

export default function Page() {
  return (
    <div>
      <ClientOnly />
    </div>
  );
}

✅ Paso 3: Previene el problema en iOS (frecuente en App Router)

Agrega este <meta> en tu <head> global (en app/layout.tsx):

// app/layout.tsx
export const metadata = {
  title: 'My App',
  description: '...',
  metadataBase: new URL('https://example.com'),
};

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="es">
      <head>
        <meta
          name="format-detection"
          content="telephone=no, date=no, email=no, address=no"
        />
      </head>
      <body>{children}</body>
    </html>
  );
}

🔍 Verifica: Abre tu app en Safari iOS y busca si números como 555-1234 se convierten en enlaces azules → si sí, el problema es este.

Pro-tip: Diagnóstico rápido con DevTools

Abre Chrome DevTools → F12
Ve a la pestaña Elements
Haz clic derecho en el <body> → Break on → subtree modifications
Recarga la página
Cuando se detenga el debugger, revisa qué código modificó el DOM antes de que React hidrate

📌 Error común en Next.js 13+: Usar use client en componentes que renderizan contenido dinámico sin manejar el estado de mount. Siempre usa el patrón useState + useEffect para evitar mismatches.

Código corregido (ejemplo real)

// components/DateTime.tsx
'use client';

import { useState, useEffect } from 'react';

export default function DateTime() {
  const [mounted, setMounted] = useState(false);
  const [now, setNow] = useState<Date | null>(null);

  useEffect(() => {
    setMounted(true);
    setNow(new Date());
  }, []);

  if (!mounted) return <span aria-hidden="true">Loading...</span>;

  return (
    <time 
      dateTime={now?.toISOString()} 
      suppressHydrationWarning
    >
      {now?.toLocaleString()}
    </time>
  );
}

✅ Resultado: Sin mismatches, compatible con SSR, iOS y extensiones de navegador.

Cómo solucionar el error “Enable JavaScript and cookies to continue”

Erick Eduardo Ramos — Thu, 17 Sep 2026 14:01:20 +0000

Cómo solucionar el error “Enable JavaScript and cookies to continue”

Este mensaje aparece cuando Cloudflare (u otro proxy de seguridad similar) detecta que el navegador del usuario no cumple con los requisitos mínimos de seguridad para acceder al sitio: JavaScript deshabilitado o cookies bloqueadas.

🔍 Raíz del problema

Cloudflare implementa mecanismos de protección como Browser Integrity Check y Challenge (desafío de JavaScript). Cuando un cliente (navegador, scraper, bot o script) intenta acceder sin ejecutar el JavaScript necesario para validar su integridad (o sin permitir cookies), Cloudflare bloquea la solicitud y muestra este mensaje.

Causas comunes:

El navegador tiene JavaScript deshabilitado.
Las cookies están bloqueadas (por configuración de privacidad, extensiones como uBlock Origin, o modo incógnito restringido).
Se está usando un cliente HTTP sin soporte para JS (ej. curl, requests en Python sin renderizado).
El servidor no está configurado correctamente para permitir la validación de Cloudflare (ej. bloqueo de __cf_bm o cf_clearance).
En entornos de automatización (Selenium, Puppeteer), el navegador no pasa el JavaScript challenge correctamente.

✅ Solución definitiva (por escenario)

🧪 1. Si eres un usuario final

Habilita JavaScript en tu navegador:
- Chrome: Configuración > Privacidad y seguridad > Seguridad > Habilitar JavaScript.
- Firefox: Preferencias > Privacidad y seguridad > Permisos > Habilitar JavaScript.
Permite cookies de terceros (especialmente de cloudflare.com).
Desactiva temporalmente extensiones de bloqueo (uBlock, Privacy Badger, etc.).
Reinicia el navegador y vuelve a intentar.

🛠️ 2. Si eres desarrollador y usas automatización (Puppeteer/Selenium)

Cloudflare bloquea bots por defecto. Usa bypasses oficiales y técnicas de evasión:

✅ Solución recomendada: `puppeteer-extra` + `stealth-plugin`

npm install puppeteer puppeteer-extra puppeteer-extra-plugin-stealth

const puppeteer = require('puppeteer-extra');
const StealthPlugin = require('puppeteer-extra-plugin-stealth');
puppeteer.use(StealthPlugin());

(async () => {
  const browser = await puppeteer.launch({
    headless: 'new',
    args: ['--no-sandbox', '--disable-setuid-sandbox']
  });
  const page = await browser.newPage();

  await page.goto('https://tu-sitio.com', { waitUntil: 'networkidle0' });

  // Espera explícita al desafío Cloudflare y resuélvelo
  try {
    await page.waitForSelector('#challenge-form', { timeout: 10000 });
    await page.waitForFunction(() => {
      return typeof __cfRLBypass !== 'undefined' || 
             document.querySelector('#challenge-form')?.style?.display === 'none';
    }, { timeout: 15000 });
  } catch (e) {
    console.warn('No se detectó desafío Cloudflare o ya fue superado.');
  }

  // Ahora puedes extraer contenido
  const content = await page.content();
  console.log(content);
  await browser.close();
})();

⚠️ Importante: Cloudflare cambia sus desafíos frecuentemente. Usa siempre la versión más reciente de puppeteer-extra-plugin-stealth.

🧰 3. Si usas Python (`requests`/`httpx`)

No puedes resolver el desafío con requests puro. Necesitas un renderizador (ej. playwright o selenium):

✅ Solución con `playwright` (recomendado):

pip install playwright
playwright install chromium

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=True)
    context = browser.new_context()
    page = context.new_page()

    page.goto("https://tu-sitio.com", wait_until="networkidle")

    # Espera hasta que desaparezca el desafío (o hasta que se cargue el contenido real)
    page.wait_for_selector("body:not(:has(#challenge-error-text))", timeout=30000)

    content = page.content()
    print(content)

    browser.close()

🌐 4. Si eres administrador del sitio

Asegúrate de que:

El servidor no bloquea los headers necesarios (CF-Connecting-IP, CF-IPCountry, etc.).
No hay reglas de firewall que interfieran con el desafío JS.
Si usas Cloudflare, desactiva temporalmente el modo "Under Attack" (en Security > WAF) para probar.
Verifica que los archivos cdn-cgi estén accesibles (Cloudflare los usa para servir el JS de desafío).

🧠 Pro-tip

Nunca confíes en requests para sitios con Cloudflare. Si necesitas scraping fiable, usa:

playwright o puppeteer con stealth-plugin.

O servicios especializados como ScraperAPI, Bright Data, o Zenscrape que ya resuelven los desafíos por ti.

✅ Verifica si el problema es del cliente o del servidor:

Abre el sitio en modo incógnito (sin extensiones). Si funciona → problema del navegador/cliente.

Si falla en todos los navegadores → problema de configuración del servidor/proxy.

✅ Solución aplicada: Con esto el error desaparecerá. No hay atajos: si el desafío JS no se ejecuta, Cloudflare bloquea.

Cómo solucionar `Code exited (1)` en Docker en Raspberry Pi

Erick Eduardo Ramos — Wed, 16 Sep 2026 13:57:34 +0000

Cómo solucionar `Code exited (1)` en Docker en Raspberry Pi

El error Exited (1) indica que el proceso principal del contenedor terminó con un código de error (1 es el genérico para "error no especificado"). En Raspberry Pi, este problema no es casualidad: es un síntoma de incompatibilidad entre la arquitectura del contenedor y el hardware del dispositivo.

¿Por qué ocurre?

Arquitectura incompatible: La imagen myimage probablemente fue construida para amd64 (x86_64), pero Raspberry Pi usa arm32v7 o arm64v8.
Docker no da un error explícito al pull si la imagen no tiene manifest para tu arquitectura, pero al run, el binario no se ejecuta y el proceso sale inmediatamente con código 1.
El hecho de que funcione en una VM de Raspberry Pi (probablemente una VM x86_64 emulada) confirma esta hipótesis.

Pasos para solucionarlo

1. Verifica la arquitectura de tu Raspberry Pi

uname -m
# Salida típica: armv7l (32-bit) o aarch64 (64-bit)

2. Verifica la arquitectura de tu imagen

docker inspect myimage --format '{{.Architecture}}'
# Salida esperada: amd64 (incompatible), armv7l (compatible), etc.

3. Construye o descarga una imagen compatible con ARM

Opción A: Usa imágenes oficiales con soporte multi-arch (recomendado)

docker pull arm32v7/python:3.9-slim  # Ejemplo para Raspberry Pi 3/4 32-bit
# o
docker pull arm64v8/python:3.9-slim  # Para Raspberry Pi 4/5 64-bit

Opción B: Construye localmente desde Dockerfile (si tienes acceso)

Asegúrate de que el FROM sea compatible:

# Para Raspberry Pi 3/4 32-bit
FROM arm32v7/python:3.9-slim

# Para Raspberry Pi 4/5 64-bit
# FROM arm64v8/python:3.9-slim

Opción C: Usa `--platform` con `docker buildx` (recomendado para CI/CD)

docker buildx build --platform linux/arm/v7 -t myimage:armv7 . --load
# o para 64-bit:
# docker buildx build --platform linux/arm64 -t myimage:arm64 . --load

4. Ejecuta el contenedor corregido

docker run --net=host -d -t myimage:armv7

⚠️ Nota crítica: El comando original tiene un error de sintaxis: --net = host → debe ser --net host (sin espacios alrededor del =). Esto también puede causar fallos en versiones antiguas de Docker.

Bloque de código corregido (ejemplo completo)

# Verifica arquitectura
uname -m

# Construye imagen compatible (ejemplo con Python)
docker buildx build \
  --platform linux/arm/v7 \
  -t myimage:armv7 \
  . \
  --load

# Ejecuta con sintaxis correcta
docker run --net host -d -t myimage:armv7

# Verifica logs si sigue fallando
docker logs <container_id>

Pro-tip: Diagnóstico rápido de exit code 1 en Raspberry Pi

Ejecuta sin -d para ver el error en tiempo real:

   docker run --net host -t myimage

(Sin -d, el contenedor no se ejecuta en segundo plano y verás el output del error)

Verifica si el binario principal existe y es ejecutable:

   docker run --rm -it --entrypoint /bin/sh myimage
   # Dentro del contenedor:
   ls -l /usr/local/bin/your-app || ls -l /app/your-app
   file /usr/local/bin/your-app  # Verifica arquitectura

Habilita logs de Docker para más detalles:

   sudo journalctl -u docker.service -f

Con esto, el contenedor dejará de salir con código 1 y funcionará correctamente en tu Raspberry Pi física.

Cómo solucionar \"Text content does not match server-rendered HTML\" en Next.js App Router

Erick Eduardo Ramos — Tue, 15 Sep 2026 14:04:20 +0000

Cómo solucionar "Text content does not match server-rendered HTML" en Next.js App Router

Este error ocurre cuando el HTML generado en el servidor (server-side rendering) no coincide con el árbol de React generado durante la primera renderización en el navegador (client-side hydration). React detecta esta inconsistencia y lanza una advertencia crítica porque puede romper la interactividad y causar comportamientos impredecibles.

Causa raíz

La mayoría de los casos se deben a:

Uso de APIs del navegador (window, localStorage, Date.now(), etc.) directamente en el renderizado.
Lógica condicional basada en typeof window !== 'undefined' dentro del cuerpo del componente (no dentro de useEffect).
Elementos HTML anidados inválidos según el estándar (ej. <p> dentro de otro <p>, <button> dentro de <button>).
Extensiones del navegador que modifican el DOM antes de la hidratación.
Metaetiqueta de detección automática de iOS (format-detection) que inyecta <a> dinámicos en números de teléfono o fechas.

Solución definitiva (pasos verificados)

✅ Paso 1: Aisla la fuente de la inconsistencia

Busca en tu código:

Uso directo de window, localStorage, navigator, Date(), Math.random(), etc. en el cuerpo del componente.
Lógica condicional como if (typeof window !== 'undefined') { ... } fuera de hooks.

Ejemplo problemático:

// ❌ INCORRECTO: Se ejecuta en SSR y en CSR con resultados distintos
function Timestamp() {
  const now = new Date(); // ❌ Diferente en SSR vs CSR
  return <time>{now.toLocaleString()}</time>;
}

✅ Paso 2: Aplica la solución según el caso

🔹 Caso A: Contenido dinámico (fechas, IDs aleatorios, etc.)

Usa suppressHydrationWarning en el elemento problemático:

// ✅ CORRECTO: Advertencia suprimida solo en el elemento afectado
<time suppressHydrationWarning>{new Date().toLocaleString()}</time>

⚠️ Importante: Solo aplica a elementos textuales y de un solo nivel de profundidad.

🔹 Caso B: Lógica que requiere el navegador (ej. `localStorage`, `window.innerWidth`)

Usa useEffect para postergar la lógica al cliente:

// ✅ CORRECTO: Renderiza lo mismo en SSR y CSR inicialmente
import { useState, useEffect } from 'react';

function ThemeToggle() {
  const [theme, setTheme] = useState<'light' | 'dark'>('light'); // Valor por defecto seguro

  useEffect(() => {
    const stored = localStorage.getItem('theme');
    if (stored === 'dark' || stored === 'light') {
      setTheme(stored);
    }
  }, []);

  return <button className={theme}>Toggle</button>;
}

🔹 Caso C: Componente totalmente client-side (ej. canvas, mapas)

Desactiva SSR con dynamic y ssr: false:

// pages/page.tsx
import dynamic from 'next/dynamic';

const InteractiveMap = dynamic(() => import('../components/Map'), { 
  ssr: false,
  loading: () => <p>Cargando mapa...</p>
});

export default function Page() {
  return <InteractiveMap />;
}

✅ Paso 3: Verifica estructura HTML válida

Revisa que no haya:

<p> anidados (ej. <p><div>...</div></p> → inválido).
<button> dentro de <a>, o viceversa.
<ul>/<ol> dentro de <p>.
<a> dentro de <a>.

Ejemplo corregido:

// ❌ INCORRECTO
<p>
  <a href="/home">Home</a> | <a href="/about">About</a>
</p>

// ✅ CORRECTO (usar <span> o fragmento)
<span>
  <a href="/home">Home</a> | <a href="/about">About</a>
</span>

✅ Paso 4: Deshabilita detección automática en iOS (si aplica)

Agrega esta metaetiqueta en <head> de tu layout:

// app/layout.tsx
export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="es">
      <head>
        <meta name="format-detection" content="telephone=no, date=no, email=no, address=no" />
      </head>
      <body>{children}</body>
    </html>
  );
}

Pro-tip: Diagnóstico rápido

Activa React DevTools → Selecciona la pestaña "Components" y busca el ícono de advertencia (⚠️) en el árbol.
Busca en consola: El error muestra la ruta exacta del componente afectado (ej. at div (app/page.tsx:15:10)).
Prueba en modo incógnito: Si desaparece el error, es una extensión del navegador (común: Grammarly, Dark Reader, ad blockers).

Código corregido (ejemplo completo)

// app/page.tsx
import { useState, useEffect } from 'react';

function ClientOnlyContent() {
  const [data, setData] = useState<string>('Cargando...');

  useEffect(() => {
    // ✅ Solo se ejecuta en cliente
    const timer = setTimeout(() => {
      setData('Contenido generado en el cliente');
    }, 100);
    return () => clearTimeout(timer);
  }, []);

  return <p>{data}</p>;
}

export default function Page() {
  return (
    <main>
      <h1>App Router</h1>
      <ClientOnlyContent />
      {/* ✅ Supresión segura para fechas dinámicas */}
      <p>Última actualización: <time suppressHydrationWarning>{new Date().toLocaleDateString()}</time></p>
    </main>
  );
}

✅ Validación final: Ejecuta next build y revisa los logs. Si no hay errores de hidratación, ¡solucionado.

Cómo solucionar el error \"Enable JavaScript and cookies to continue\"

Erick Eduardo Ramos — Mon, 14 Sep 2026 15:32:54 +0000

Cómo solucionar el error "Enable JavaScript and cookies to continue"

Este mensaje aparece cuando Cloudflare (u otro proxy de seguridad similar) bloquea la solicitud del navegador porque detecta que JavaScript está deshabilitado o no se cumplen los requisitos mínimos de seguridad para permitir el acceso.

¿Por qué ocurre?

Cloudflare implementa un desafío de seguridad (JavaScript Challenge) para verificar que el cliente es un navegador real y no un bot malicioso. El flujo es el siguiente:

El navegador hace una solicitud HTTP a tu sitio.
Cloudflare intercepta la petición y responde con una página HTML que contiene un script de verificación (_cf_chl_opt).
El navegador debe ejecutar ese script, que calcula un token criptográfico y lo envía como cookie o parámetro.
Si JavaScript está deshabilitado, la cookie no se establece, y Cloudflare sigue mostrando el mensaje de error.

⚠️ Causas comunes en desarrollo:

Pruebas locales sin configurar correctamente localhost con HTTPS (Cloudflare requiere HTTPS para el desafío).
Uso de navegadores headless (Puppeteer, Playwright, Selenium) sin habilitar JS.
Configuración errónea de Cloudflare Rocket Loader o Browser Integrity Check.
Solicitudes automatizadas (crawlers, scripts, tests) que no simulan un navegador real.

Pasos para solucionarlo

✅ 1. Verifica que JavaScript esté habilitado en el navegador

En Chrome/Firefox/Edge: abre chrome://settings/content/javascript → Permitir que todos los sitios ejecuten JavaScript.
En modo incógnito: prueba con una ventana limpia (sin extensiones que bloqueen JS).

✅ 2. Si usas Cloudflare, ajusta los ajustes de seguridad

Ve a Cloudflare Dashboard → Security → WAF → Browser Integrity Check y:

Desactiva temporalmente el modo High o Under Attack.
O bien, cambia a "Essential" (menos estricto).

También revisa:

Cloudflare Dashboard → Scrape Shield → Disable "Browser Integrity Check" (solo si no lo necesitas para producción).

✅ 3. Para entornos de desarrollo local

Usa https://localhost con certificado autofirmado válido (Chrome lo acepta tras añadir una excepción).
O mejor: usa ngrok o cloudflared para exponer tu localhost con HTTPS real:

  ngrok http 3000
  # Luego configura tu dominio en Cloudflare para apuntar a `xxx.ngrok.io`

✅ 4. Si usas Puppeteer/Playwright: habilita JS y cookies

Puppeteer (Node.js)

const browser = await puppeteer.launch({
  headless: 'new',
  args: ['--disable-web-security', '--disable-features=IsolateOrigins,site-per-process']
});

const page = await browser.newPage();
await page.setCookie({
  name: 'test',
  value: '1',
  domain: 'tu-dominio.com'
});
await page.goto('https://tu-dominio.com', { waitUntil: 'networkidle0' });

Playwright (Node.js)

const context = await browser.newContext({
  permissions: ['geolocation'],
  viewport: { width: 1280, height: 720 }
});
const page = await context.newPage();
await page.goto('https://tu-dominio.com', { waitUntil: 'domcontentloaded' });
// Si es necesario, espera explícitamente al desafío:
await page.waitForSelector('#challenge-form', { timeout: 5000 });
await page.evaluate(() => document.getElementById('challenge-form').submit());

✅ 5. Para pruebas unitarias o scripts automatizados

Evita pasar por el desafío Cloudflare:

Usa un entorno sin Cloudflare (ej. 127.0.0.1:3000 sin proxy).
O configura una regla en Cloudflare para excluir rutas de prueba del WAF:
- Cloudflare Dashboard → Rules → Firewall Rules → Create Rule
- Expression: http.host eq "test.tu-dominio.com" and not ip.src in {192.168.0.0/16}
- Action: Skip

Bloque de código corregido (ejemplo práctico: Puppeteer + bypass)

// bypass-cloudflare.js
const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch({
    headless: 'new',
    args: [
      '--no-sandbox',
      '--disable-setuid-sandbox',
      '--disable-dev-shm-usage',
      '--disable-web-security',
      '--disable-features=IsolateOrigins,site-per-process'
    ]
  });

  const page = await browser.newPage();
  // Forzar cookies y JS
  await page.setCookie({ name: 'cf_clearance', value: 'dummy', domain: '.tu-dominio.com' });
  await page.goto('https://tu-dominio.com', {
    waitUntil: 'networkidle0',
    timeout: 60000
  });

  // Esperar y resolver el desafío si es necesario
  try {
    await page.waitForSelector('#challenge-form', { timeout: 5000 });
    await page.evaluate(() => {
      const form = document.getElementById('challenge-form');
      if (form) form.submit();
    });
    await page.waitForNavigation({ waitUntil: 'networkidle0' });
  } catch (e) {
    console.log('No se detectó desafío (ya pasó)');
  }

  console.log('✅ Acceso permitido. Título:', await page.title());
  await browser.close();
})();

Pro-tip: Evita el desafío en producción

No expongas tu API directamente detrás de Cloudflare sin autenticación.
Usa un endpoint /health sin Cloudflare (o con regla de exclusión) para monitoreo.
Para bots legítimos (Googlebot, Bingbot), configura Cloudflare → Crawler Intelligence → Allow.
Si usas Cloudflare para protección, nunca desactives el WAF en producción; en su lugar, usa cf_clearance dinámico o integra un resolver de desafíos (como cloudscraper) solo en entornos controlados.

🔑 Clave final: Este error nunca es un bug en tu código frontend. Es una medida de seguridad activa. Soluciónalo configurando correctamente el entorno, no el código.

Cómo solucionar el error \"Enable JavaScript and cookies to continue\"

Erick Eduardo Ramos — Sun, 13 Sep 2026 13:34:38 +0000

Cómo solucionar el error "Enable JavaScript and cookies to continue"

¿Por qué ocurre?

Este mensaje aparece cuando un sitio web (especialmente uno protegido por Cloudflare) detecta que el navegador del cliente no tiene JavaScript habilitado o no permite cookies, lo cual es obligatorio para pasar el desafío de seguridad (como el JavaScript Challenge o Browser Integrity Check). En entornos de automatización (scraping, pruebas con Selenium, etc.), este error suele ocurrir porque:

El controlador del navegador (p. ej., ChromeDriver) se está ejecutando sin cookies habilitadas.
Se está usando una sesión de navegador sin persistencia de cookies (como --disable-cookies o --incognito sin configuración explícita).
Se está realizando una solicitud HTTP directa (p. ej., con requests en Python) sin emular un navegador real ni manejar el desafío de Cloudflare.
El navegador está configurado para bloquear cookies de terceros y Cloudflare las necesita para validar la sesión.

Pasos para solucionarlo

✅ Caso 1: Automatización con Selenium (Python)

1. Configura el navegador para permitir cookies y JS

Asegúrate de no deshabilitar cookies ni JavaScript explícitamente y usa opciones estándar:

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

options = Options()
options.add_argument("--disable-blink-features=AutomationControlled")
options.add_experimental_option("excludeSwitches", ["enable-automation"])
options.add_experimental_option("useAutomationExtension", False)
# Asegura que las cookies y JS estén habilitados (por defecto, pero refuerzo explícito)
options.add_argument("--enable-javascript")
options.add_argument("--enable-cookies")

driver = webdriver.Chrome(options=options)
driver.execute_cdp_cmd('Page.setCookie', {
    "name": "test_cookie",
    "value": "1",
    "domain": ".example.com",  # ajusta al dominio real
    "path": "/",
    "secure": False,
    "httpOnly": False
})
driver.get("https://example.com")

2. Usa `undetected-chromedriver` (recomendado para Cloudflare)

pip install undetected-chromedriver

import undetected_chromedriver as uc

driver = uc.Chrome()
driver.get("https://example.com")
# Cloudflare será superado automáticamente en la mayoría de los casos

✅ Caso 2: Uso de `requests` o librerías HTTP directas

No funcionará si el sitio usa Cloudflare sin un solver. Debes usar una herramienta que emule un navegador real o resuelva el desafío.

Solución recomendada: `cloudscraper`

pip install cloudscraper

import cloudscraper

scraper = cloudscraper.create_scraper(
    browser={
        'browser': 'firefox',
        'platform': 'windows',
        'mobile': False
    }
)
resp = scraper.get("https://example.com")
print(resp.text)

⚠️ Si el sitio usa Cloudflare Anti-Bot con desafíos avanzados (como JS challenge dinámico), cloudscraper puede fallar. En ese caso, usa Selenium + undetected-chromedriver o servicios como Browserless.io o Zenscrape.

✅ Caso 3: Configuración manual del navegador (pruebas manuales)

En Chrome: Configuración > Privacidad y seguridad > Cookies y otros datos de sitio > Permitir cookies.
Desactiva extensiones que bloqueen scripts (uBlock Origin, Privacy Badger, etc.).
Reinicia el navegador y vuelve a cargar la página.

Bloque de código corregido (ejemplo definitivo con Selenium + undetected)

import undetected_chromedriver as uc
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# Configuración robusta
uc.patch_webdriver()

driver = uc.Chrome()
try:
    driver.get("https://example.com")
    # Espera implícita a que cargue y Cloudflare pase la validación
    WebDriverWait(driver, 15).until(
        EC.presence_of_element_located((By.TAG_NAME, "body"))
    )
    print("✅ Acceso exitoso. Contenido:", driver.page_source[:200])
finally:
    driver.quit()

Pro-tip

Nunca uses --disable-javascript ni --disable-cookies en entornos donde se requiera pasar Cloudflare.
Cloudflare cambia sus desafíos frecuentemente. Usa undetected-chromedriver o actualiza regularmente tus herramientas.
Si el problema persiste, captura el HTML inicial y verifica si el <script> de Cloudflare (src="/cdn-cgi/challenge-platform/h/g/orchestrate/...") está presente. Si no, el servidor está bloqueando la solicitud antes de llegar al desafío (posible IP bloqueada o cabeceras faltantes).

🔑 Clave final: El error no es técnico del código, sino de la falta de emulación de navegador real. Solución: usa un controlador real, no una solicitud HTTP simple.

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

Erick Eduardo Ramos — Sat, 12 Sep 2026 12:33:10 +0000

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

¿Por qué ocurre este error?

El código de salida Exited (1) indica que el proceso principal del contenedor terminó con un error genérico. En Raspberry Pi, los casos más comunes son:

Arquitectura incompatible: La imagen fue construida para amd64 pero se ejecuta en ARM (armv7l o aarch64).
Falta de binarios compatibles: El ENTRYPOINT o CMD del contenedor apunta a un ejecutable no compatible con ARM.
Problemas de permisos o recursos limitados en Raspberry Pi (memoria, CPU, dispositivos).
Uso incorrecto de --net=host: En Raspberry Pi OS (especialmente con docker-ce viejo), puede causar fallos si el kernel no lo soporta bien.

🔍 Nota crítica: En tu comando docker run --net = host, hay espacios alrededor del =. Esto es inválido y Docker lo interpreta como un nombre de red literal = host, lo que provoca fallos silenciosos o errores de red que terminan matando el contenedor.

Pasos para solucionarlo (ordenados por prioridad)

1. Corrige el error de sintaxis en `--net`

Elimina los espacios alrededor del =:

# ❌ Incorrecto (como lo escribiste):
docker run --net = host -d -t myimage

# ✅ Correcto:
docker run --net host -d -t myimage

⚠️ Este es el error más probable en tu caso, ya que funciona en la VM (probablemente x86_64 con Docker más reciente que tolera errores de parsing) pero falla en Raspberry Pi (donde el parser es más estricto).

2. Verifica la arquitectura de la imagen

Ejecuta en tu Raspberry Pi:

docker images --digests myimage
docker inspect myimage | grep -A5 '"Architecture"'

Si ves "Architecture": "amd64", necesitas reconstruir la imagen para ARM:

# Opción 1: Reconstruir localmente en Raspberry Pi
docker build -t myimage-arm .

# Opción 2: Usar buildx para multi-arch
docker buildx build --platform linux/arm/v7 -t myimage-arm .

3. Ejecuta en primer plano para ver el error real

# Quita -d para ver logs en tiempo real:
docker run --net host -it --rm myimage

Esto mostrará el stack trace o mensaje de error que causó el exit 1.

4. Verifica compatibilidad del kernel y Docker

En Raspberry Pi, asegúrate de tener:

Docker versión ≥ 20.10 (recomendado)
Kernel ≥ 5.10 (para mejor soporte de cgroups v2)

docker --version
uname -r

Si usas Raspberry Pi OS Lite (sin GUI), activa cgroups v1 si es necesario:

sudo nano /boot/cmdline.txt
# Agrega al final: cgroup_enable=cpuset cgroup_memory=1 cgroup_enable=memory

Bloque de código corregido (ejemplo funcional)

# Paso 1: Corregir sintaxis y ejecutar en primer plano para debug
docker run --net host -it --rm myimage

# Paso 2: Si falla por arquitectura, reconstruir para ARM
docker buildx build --platform linux/arm/v7 -t myimage-arm:latest .

# Paso 3: Ejecutar la imagen corregida
docker run --net host -d -t myimage-arm

Pro-tip: Diagnóstico rápido con `docker inspect`

# Obtener el último contenedor que falló:
CONTAINER_ID=$(docker ps -aq -f "ancestor=myimage" -l)
docker inspect $CONTAINER_ID --format '{{.State.ExitCode}} - {{.State.Error}}'

Esto te dará el mensaje de error exacto (ej: exec format error, no such file or directory, etc.), clave para identificar si es problema de arquitectura o falta de dependencias.

💡 Dato clave: Si el error es exec format error, es 100% problema de arquitectura. No hay forma de ejecutar binarios amd64 en ARM sin emulación (QEMU), y esa emulación es lenta y propensa a fallos en Raspberry Pi.

Cómo solucionar el error “Enable JavaScript and cookies to continue”

Erick Eduardo Ramos — Fri, 11 Sep 2026 13:09:34 +0000

Cómo solucionar el error “Enable JavaScript and cookies to continue”

Este error aparece cuando Cloudflare (u otro proxy inverso de seguridad) bloquea la solicitud porque detecta que el navegador no cumple con los requisitos mínimos de seguridad: JavaScript deshabilitado o cookies rechazadas. Es un mecanismo de protección contra bots y tráfico malicioso.

¿Por qué ocurre?

El navegador del cliente no ejecuta JavaScript (o está deshabilitado).
Las cookies no están habilitadas, o el dominio está bloqueado en la configuración de privacidad del navegador.
El cliente usa un crawler, scraper o cliente HTTP no-browser (ej. curl, requests en Python) que no simula un entorno real.
En entornos de automatización (Selenium, Playwright), el navegador se inicia sin habilitar explícitamente JavaScript o cookies.
En aplicaciones web, el usuario está usando una extensión (como uBlock Origin, Privacy Badger) que bloquea scripts esenciales de Cloudflare.

Pasos para solucionarlo

✅ 1. Verifica que JavaScript y cookies estén habilitados en el navegador

Chrome/Edge:

Configuración → Privacidad y seguridad → Cookies y otros datos de sitio → Permitir cookies y guardar datos de sitios.

Accesibilidad → Activar JavaScript.
Firefox:

Preferencias → Privacidad y seguridad → Cookies y datos de sitios → Acepta cookies y datos de sitios.

Configuración avanzada → Sistema → Activar JavaScript.
Desactiva temporalmente extensiones de bloqueo (uBlock, Privacy Badger, NoScript).

✅ 2. Si usas automatización (Selenium, Playwright, Puppeteer)

🔧 Selenium (Python)

from selenium import webdriver
from selenium.webdriver.chrome.options import Options

options = Options()
options.add_argument("--disable-blink-features=AutomationControlled")
options.add_experimental_option("excludeSwitches", ["enable-automation"])
options.add_experimental_option("useAutomationExtension", False)
# Habilita cookies y JS (por defecto ya están, pero refuerza)
options.add_argument("--enable-javascript")
options.add_argument("--enable-cookies")

driver = webdriver.Chrome(options=options)
driver.execute_cdp_cmd('Page.setCookie', {
    'name': 'test_cookie',
    'value': '1',
    'domain': '.tu-dominio.com'
})
driver.get("https://tu-dominio.com")

🔧 Playwright (Node.js)

const { chromium } = require('playwright');

const browser = await chromium.launch({
  headless: false,
  args: [
    '--disable-features=IsolateOrigins,site-per-process',
    '--enable-javascript',
    '--enable-cookies'
  ]
});
const context = await browser.newContext({
  javaScriptEnabled: true,
  httpCredentials: null,
  permissions: ['geolocation', 'notifications'],
  storageState: { cookies: [], origins: [] } // Asegura que se permitan cookies
});
const page = await context.newPage();
await page.goto('https://tu-dominio.com');

✅ 3. Si eres el desarrollador del sitio (configuración Cloudflare)

Verifica que no estés usando "Under Construction" o modo "I'm Under Attack" en la pestaña Security de Cloudflare.
Ajusta el nivel de desafío: Security → Settings → Browser Integrity Check → Low o Essentially Off.
Excluye rutas de API o bots confiables usando reglas de firewall (ej. ip.src in {1.2.3.4}).

✅ 4. Si el problema ocurre en un iframe o embedded webview

En Android/iOS: asegúrate de que setJavaScriptEnabled(true) y setAcceptCookies(true) estén activados.
En Electron: usa webPreferences: { javascript: true, cookies: true, nodeIntegration: false }.

Bloque de código corregido (ejemplo mínimo en Python con `requests` + Cloudflare bypass)

⚠️ No es recomendable para producción, pero útil para pruebas rápidas:

import cloudscraper

scraper = cloudscraper.create_scraper(
    browser={
        'browser': 'firefox',
        'platform': 'windows',
        'mobile': False
    }
)
response = scraper.get("https://tu-dominio.com")
print(response.text)

Instala primero:

pip install cloudscraper

Nota crítica: Si el sitio usa Cloudflare Turnstile (captcha sin interacción), necesitarás resolverlo explícitamente con cloudscraper + turnstile-token o usar herramientas como cfscrape + turnstile-solver.

Pro-tip

El error no es del cliente, es del entorno de ejecución.

Si tú controlas el backend, evita usar Cloudflare para rutas de API (usa API Protection o Bot Fight Mode solo en endpoints públicos).

Para pruebas automatizadas, simula un navegador real con headers completos (User-Agent, Accept-Language, Sec-Fetch-*, etc.).

Usa navigator.webdriver detection bypass:
Object.defineProperty(navigator, 'webdriver', { get: () => false });
(pero recuerda: esto solo es ético en entornos de testing autorizados).

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

Erick Eduardo Ramos — Thu, 10 Sep 2026 13:15:31 +0000

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

¿Por qué ocurre este error?

El código de salida 1 indica que el proceso principal del contenedor terminó con un error genérico. En Raspberry Pi, los casos más comunes son:

Arquitectura incompatible: La imagen se construyó para amd64 (x86_64) pero Raspberry Pi usa arm32v7 o arm64v8.
Falta de binarios compatibles: El ENTRYPOINT o CMD del contenedor no existe o no es ejecutable en ARM.
Problemas de permisos o dependencias faltantes: Librerías del sistema (como libc, libstdc++, etc.) no están disponibles en la versión del sistema operativo de la Pi.
Uso de --net=host mal formateado: El espacio después del = (--net = host) es inválido y puede causar fallos silenciosos.

🔍 Nota crítica: El error se presenta solo en la Raspberry Pi física, pero funciona en una VM. Esto apunta fuertemente a incompatibilidad de arquitectura.

Pasos para solucionarlo

1. Verifica la arquitectura de tu Raspberry Pi

uname -m
# Salida esperada: armv7l (Raspberry Pi 3/4 32-bit) o aarch64 (Raspberry Pi 4/5 64-bit)

2. Verifica la arquitectura de tu imagen

docker inspect myimage --format '{{.Architecture}}'
# Si muestra "amd64", es incompatible con Raspberry Pi

3. Corrige el comando `docker run`

El error de sintaxis es crítico:

# ❌ INCORRECTO (espacios alrededor del '=')
docker run --net = host -d -t myimage

# ✅ CORRECTO (sin espacios)
docker run --net host -d -t myimage

⚠️ --net = host hace que Docker interprete = como parte del valor del flag --net, lo que genera un error silencioso y el contenedor falla al iniciar.

4. Ejecuta en primer plano para diagnosticar

docker run --net host -it --rm myimage

Elimina -d (background) y -t (TTY), añade -it para ver logs en tiempo real.
Si falla, verás el mensaje de error directamente (ej: exec format error, No such file or directory, etc.).

5. Solución definitiva: reconstruye la imagen para ARM

Opción A: Usa imágenes oficiales con soporte multi-arch

docker pull arm32v7/alpine:latest  # Para Pi 3/4 32-bit
docker pull arm64v8/alpine:latest  # Para Pi 4/5 64-bit

Opción B: Construye tu imagen con `docker buildx`

# Habilita buildx
docker buildx create --use

# Construye para ARM
docker buildx build \
  --platform linux/arm/v7,linux/arm64 \
  -t myimage:latest \
  --push \
  .

Opción C: Usa QEMU para emulación (solo para depuración)

docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
docker run --platform linux/arm/v7 myimage

❗ No recomendado para producción: es lento y puede fallar por falta de drivers específicos.

Bloque de código corregido (ejemplo funcional)

# Paso 1: Verifica arquitectura
uname -m

# Paso 2: Corrige el comando (¡sin espacios!)
docker run --net host -d -t myimage

# Paso 3: Si sigue fallando, ejecuta en primer plano
docker run --net host -it --rm myimage

# Paso 4: Si el error es "exec format error", reconstruye para ARM
docker buildx build --platform linux/arm/v7 -t myimage-arm:latest .

Pro-tip: Diagnóstico rápido con `docker logs`

Si ya tienes el contenedor en estado Exited (1):

# Recupera logs del último contenedor
docker logs $(docker ps -lq)

# O inspecciona el código de salida explícitamente
docker inspect $(docker ps -lq) --format '{{.State.ExitCode}}'

📌 Consejo final: En Raspberry Pi, nunca uses imágenes amd64 nativas. Usa siempre imágenes con etiquetas arm32v7, arm64v8 o construidas con buildx. El error Exited (1) en Pi es casi siempre un problema de arquitectura o sintaxis en el comando.

DEV Community: Erick Eduardo Ramos

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

Cómo solucionar docker run con exit code 1 en Raspberry Pi

¿Por qué ocurre este error?

Pasos para solucionarlo

Paso 1: Corrige la sintaxis del comando

Paso 2: Verifica la arquitectura de la imagen

Paso 3: Construye o descarga una imagen compatible

Paso 4: Ejecuta en primer plano para depurar

Paso 5: Verifica logs si el contenedor ya se ejecutó

Bloque de código corregido (ejemplo funcional)

Pro-tip: Usa docker buildx para multiarquitectura

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

Cómo solucionar docker run con exit code 1 en Raspberry Pi

¿Por qué ocurre?

Pasos para solucionarlo

1. Verifica el código de error real

2. Confirma la arquitectura de tu imagen

3. Construye la imagen para ARM (si no tienes una versión compatible)

4. Usa el flag --net=host correctamente (sin espacios)

5. Verifica el contenedor en primer plano para debug

Bloque de código corregido (ejemplo funcional)

Pro-tip: Diagnóstico rápido con docker events

Cómo solucionar `Code exited (1)` en Docker en Raspberry Pi

Cómo solucionar Code exited (1) en Docker en Raspberry Pi

Explicación técnica

Pasos para solucionarlo

✅ Paso 1: Verifica la arquitectura de tu imagen y del host

✅ Paso 2: Ejecuta el contenedor en primer plano para ver el error real

✅ Paso 3: Construye la imagen para ARM (solución definitiva)

Opción A: Usa buildx para construir multi-arch (recomendado)

Opción B: Si ya tienes la imagen x86 y no puedes reconstruirla

Bloque de código corregido (ejemplo práctico)

Dockerfile para Raspberry Pi 3/4 (32-bit)

Comando de ejecución corregido (sin espacios en --net)

Pro-tip: Diagnóstico rápido con strace

Cómo solucionar \"Text content does not match server-rendered HTML\" en Next.js App Router

Cómo solucionar "Text content does not match server-rendered HTML" en Next.js App Router

Causa raíz

Solución definitiva (pasos verificados)

✅ Paso 1: Identifica la fuente del mismatch

✅ Paso 2: Aplica la solución correcta según el caso

Caso A: Contenido dinámico (fechas, IDs, tokens)

Caso B: Lógica condicional basada en cliente/servidor

Caso C: Componentes que dependen de APIs del navegador

✅ Paso 3: Previene el problema en iOS (frecuente en App Router)

Pro-tip: Diagnóstico rápido con DevTools

Código corregido (ejemplo real)

Cómo solucionar el error “Enable JavaScript and cookies to continue”

Cómo solucionar el error “Enable JavaScript and cookies to continue”

🔍 Raíz del problema

✅ Solución definitiva (por escenario)

🧪 1. Si eres un usuario final

🛠️ 2. Si eres desarrollador y usas automatización (Puppeteer/Selenium)

✅ Solución recomendada: puppeteer-extra + stealth-plugin

🧰 3. Si usas Python (requests/httpx)

✅ Solución con playwright (recomendado):

🌐 4. Si eres administrador del sitio

🧠 Pro-tip

Cómo solucionar `Code exited (1)` en Docker en Raspberry Pi

Cómo solucionar Code exited (1) en Docker en Raspberry Pi

¿Por qué ocurre?

Pasos para solucionarlo

1. Verifica la arquitectura de tu Raspberry Pi

2. Verifica la arquitectura de tu imagen

3. Construye o descarga una imagen compatible con ARM

Opción A: Usa imágenes oficiales con soporte multi-arch (recomendado)

Opción B: Construye localmente desde Dockerfile (si tienes acceso)

Opción C: Usa --platform con docker buildx (recomendado para CI/CD)

4. Ejecuta el contenedor corregido

Bloque de código corregido (ejemplo completo)

Pro-tip: Diagnóstico rápido de exit code 1 en Raspberry Pi

Cómo solucionar \"Text content does not match server-rendered HTML\" en Next.js App Router

Cómo solucionar "Text content does not match server-rendered HTML" en Next.js App Router

Causa raíz

Solución definitiva (pasos verificados)

✅ Paso 1: Aisla la fuente de la inconsistencia

✅ Paso 2: Aplica la solución según el caso

🔹 Caso A: Contenido dinámico (fechas, IDs aleatorios, etc.)

🔹 Caso B: Lógica que requiere el navegador (ej. localStorage, window.innerWidth)

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

Pro-tip: Usa `docker buildx` para multiarquitectura

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

4. Usa el flag `--net=host` correctamente (sin espacios)

Pro-tip: Diagnóstico rápido con `docker events`

Cómo solucionar `Code exited (1)` en Docker en Raspberry Pi

Opción A: Usa `buildx` para construir multi-arch (recomendado)

Comando de ejecución corregido (sin espacios en `--net`)

Pro-tip: Diagnóstico rápido con `strace`

✅ Solución recomendada: `puppeteer-extra` + `stealth-plugin`

🧰 3. Si usas Python (`requests`/`httpx`)

✅ Solución con `playwright` (recomendado):

Cómo solucionar `Code exited (1)` en Docker en Raspberry Pi

Opción C: Usa `--platform` con `docker buildx` (recomendado para CI/CD)

🔹 Caso B: Lógica que requiere el navegador (ej. `localStorage`, `window.innerWidth`)

2. Usa `undetected-chromedriver` (recomendado para Cloudflare)

✅ Caso 2: Uso de `requests` o librerías HTTP directas

Solución recomendada: `cloudscraper`

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

1. Corrige el error de sintaxis en `--net`

Pro-tip: Diagnóstico rápido con `docker inspect`

Bloque de código corregido (ejemplo mínimo en Python con `requests` + Cloudflare bypass)

Cómo solucionar `docker run` con exit code 1 en Raspberry Pi

3. Corrige el comando `docker run`

Opción B: Construye tu imagen con `docker buildx`

Pro-tip: Diagnóstico rápido con `docker logs`