Para qué sirve la herramienta imapsync
Tropical Server pone a disposición de los clientes la herramienta gratuita imapsync.tropicalserver.com para migrar el contenido de las cuentas de correo (carpetas IMAP) desde un proveedor anterior al hosting nuevo. La herramienta es idempotente: se puede lanzar varias veces sobre la misma cuenta sin duplicar mensajes, así que es habitual hacer una primera sincronización inicial y otra final justo después de cambiar los DNS.
Requisitos antes de usarla
La cuenta debe existir tanto en el servidor de origen como en el de destino (no la crea la herramienta).
Necesitas conocer:
Servidor IMAP de origen y de destino (preferentemente la IP del servidor IMAP de origen, no solo el hostname; algunos proveedores tienen el hostname tras Cloudflare y la herramienta no llega).
Usuario completo (correo electrónico).
Contraseña de la cuenta en cada lado.
Mantener la pestaña del navegador abierta durante todo el proceso. Si se cierra antes del 100%, la sincronización se interrumpe.
La barra verde y la roja superiores son indicadores fijos: el progreso real lo marca la barra inferior y el estado pasa de "Running" a "Ended" cuando termina.
Problema frecuente: la contraseña tiene caracteres especiales
Cuando la contraseña de la cuenta de origen contiene muchos caracteres especiales (por ejemplo signos como * = ( ) | ¿ ¡ ! ? & % combinados), imapsync devuelve un error de autenticación aunque esa misma contraseña sí permita acceder por Webmail. El motivo es que la herramienta web pasa la contraseña a la utilidad por línea de comandos y algunos caracteres se reinterpretan, produciendo un fallo de login.
El síntoma es claro: el Webmail del proveedor de origen acepta la contraseña, pero imapsync devuelve un error de credenciales y la sincronización no avanza.
Cómo solucionarlo
En el panel de control del proveedor de origen, cambia temporalmente la contraseña de la cuenta por una contraseña sencilla y robusta sin caracteres especiales. Por ejemplo, una secuencia alfanumérica de 16 caracteres con mayúsculas, minúsculas y dígitos.
Lanza imapsync con esa contraseña temporal y espera a que el estado quede en "Ended" con la barra al 100%.
Cuando termine, vuelve a poner la contraseña original (o establece una nueva contraseña definitiva, igualmente sin caracteres conflictivos si quieres evitar futuros problemas).
Recuerda: si vas a hacer una segunda sincronización tras propagar los DNS, repite el mismo cambio temporal antes de relanzar.
Recomendaciones generales para que la migración salga bien
Primera sincronización con los DNS aún apuntando al proveedor antiguo: permite mover el grueso del correo sin cortar el servicio.
Cambio de DNS al hosting nuevo y propagación.
Segunda sincronización tras la propagación: recupera los correos que llegaron al proveedor antiguo durante la ventana de transición.
Si una de las dos cuentas pesa mucho (varios GB) la ejecución puede tardar horas. Conviene programar la migración en una ventana de poco uso.
Si imapsync no conecta con el servidor de origen aunque las credenciales sean correctas, prueba a sustituir el hostname por la IP del servidor IMAP de origen.
Si el problema persiste
Si tras cambiar la contraseña por una temporal la herramienta sigue fallando, abre un ticket de soporte indicando el dominio, las cuentas a migrar y el servidor IMAP de origen. Desde TropicalServer podemos lanzar la sincronización por nuestros medios y dejar el resultado verificado.