# Solución de problemas

Siga la ruta en orden: el proceso de avanzada → buzón → carpeta suscrita → canal de entrega → teléfono. Una prueba de canal evita la supervisión del buzón; un nuevo mensaje comprueba toda la ruta.

## El puesto o la consola son inaccesibles

Compruebe `docker compose ps` y `docker compose logs --tail=100 core`. La vinculación de localhost es intencional; utilice un túnel SSH o un [Proxy HTTPS](https.md) que funcione desde otro dispositivo. Verifique los permisos de volumen de escritura cuando el inicio informe `data_directory_permission_denied` o `data_directory_read_only`. El contenedor se ejecuta como usuario `10001:10001`.

## Código de configuración o contraseña de administrador

Hasta que se complete la configuración, cada reinicio del puesto rota el código de configuración. Lea los registros del proceso actual. Para restablecer una contraseña de administrador, detenga el puesto y use el mismo proyecto de Compose y volumen de datos:

```sh
docker compose stop core
docker compose run --rm -it core admin reset-password
docker compose start core
```

El restablecimiento interactivo cierra las sesiones del navegador y conserva los tokens de API, los buzones de correo y el trabajo en cola. El comando de recuperación toma el bloqueo del directorio de datos, por lo que se debe detener el puesto en ejecución.

## Un mensaje nuevo no produce notificación

1. Verifique la conexión del buzón y las credenciales IMAP.
2. Compruebe que la carpeta exacta del servidor esté suscrita. Una nueva suscripción omite los mensajes antiguos.
3. Permita que pase el intervalo programado seleccionado o inspeccione la conexión en tiempo real.
4. Inspeccionar el historial de entregas. Si no hay ningún evento, investigue el seguimiento. Si un evento falló, inspeccione el error de su canal.
5. Enviar una prueba de canal. Para la aplicación Mailwake, verifique tanto el teléfono receptor seleccionado como el derecho de envío ordinario.

Un recuento de reintentos de 0 significa un intento. Auméntelo deliberadamente antes de esperar reintentos automáticos. El estado aceptado de un canal confirma la aceptación del servicio; Inspeccione el proveedor intermedio y el teléfono para detectar problemas de visualización.

## La conexión de la aplicación falla

Primero abra la dirección HTTPS del puesto en Safari. Verifique el certificado y el enrutamiento, cree una nueva invitación de cinco minutos y compare la huella criptográfica del puesto. Un error `clock_skew` requiere sincronizar el reloj del host del puesto. Verifique que el propietario otorgó los permisos requeridos y que Pro esté activo para las acciones que lo requieran.

Si el teléfono fue revocado, seleccione un nuevo teléfono receptor y guarde el canal. Después de cambiar el entorno del servicio de envío de notificaciones, utilice el restablecimiento del operador documentado en [despliegue](deploy.md) y vuelva a emparejar; las identidades ambientales permanecen separadas.

## Pide ayuda

Utilice [Problemas de GitHub](https://github.com/mingzaily/mailwake/issues) para errores de avanzada reproducibles. Incluya la versión, el código de error, el tiempo y los diagnósticos redactados de la consola. Mantenga las contraseñas, los tokens de API, los enlaces de invitación y el contenido de los mensajes fuera de los informes públicos. Informar problemas de seguridad mediante [SEGURIDAD.md](https://github.com/mingzaily/mailwake/blob/main/SECURITY.md).