---
id: reference-troubleshooting
title: Resolución de problemas
category: reference
version: 1.0
status: stable
audience:
  - user
  - administrator
  - developer
  - ai
updated_at: 2026-07-14
related:
  - flasher-using-flasher
  - diagnostics-overview
  - operations-platform-operations
tags:
  - troubleshooting
  - errors
---

# Resolución de problemas

## Web Serial no aparece

Use Chrome o Edge de escritorio y HTTPS. Cierre otras aplicaciones que usen el puerto. Compruebe cable de datos y autorización del sistema operativo.

## No entra en bootloader

Mantenga BOOT al iniciar la conexión o controle EN/IO0 según la placa. Los adaptadores USB-TTL no siempre automatizan las líneas.

## Falla a velocidad alta

Vuelva a 115200. La validación física mostró conexiones estables a esa velocidad y fallos de flujo tras cambiar a 921600 en cierto hardware.

## El archivo no cabe

Compruebe tamaño detectado, offset final y parámetro flash size. Para imágenes completas merged use 0x0. No cargue binarios como texto o Base64 en esptool-js.

## Restore no se habilita

Debe existir paquete validado, ESP32 conectado, compatibilidad no incompatible y texto RESTORE exacto. Seleccionar todas las regiones no deshabilita por sí mismo la acción, aunque muestra advertencias sensibles.

## Servicio web no responde

Revise systemd, journal, PostgreSQL, permisos de /srv, Nginx y espacio. No exponga contraseñas del entorno al recopilar logs.