Migrando de WHMCS v5 a la nueva WHMCS v6

Si gestionas un hosting o vendes servicios web, WHMCS es probablemente el corazón de tu facturación y soporte. Y como todo software crítico, tarde o temprano toca actualizarlo, un proceso que pone nervioso a cualquiera: aquí están tus clientes, sus facturas y sus dominios. En TePublico.NET hemos pasado por estas migraciones de primera mano, así que en esta guía te explicamos cómo dar el salto de WHMCS v5 a v6 sin perder datos, manteniendo intacto lo que de verdad importa: la información de tus clientes.

Qué es WHMCS y por qué actualizar

WHMCS es una de las herramientas más completas para la gestión de clientes de empresas de web hosting, servidores dedicados y servicios web en general. Automatiza la facturación, los cobros recurrentes y las renovaciones de dominios, y se integra con cPanel y WHM, además de ofrecer un centro de soporte con tickets, estado de servicios, anuncios y base de conocimiento.

Mantenerlo actualizado no es opcional: cada versión nueva trae correcciones de seguridad importantes. Una instalación de WHMCS desfasada es un riesgo real, porque maneja datos sensibles de pago y de clientes.

El caso concreto: pasar de v5 a v6

Una consulta habitual es cómo migrar o combinar instalaciones al subir de la v5 a la v6, sobre todo cuando se quieren fusionar dos instalaciones (por ejemplo, al adquirir otra empresa). El antiguo script whmcsmerge.php quedó sin mantenimiento, por lo que el camino correcto es usar el script de migración oficial que WHMCS proporciona desde el área de clientes para llevar los datos a la versión 6 ya instalada.

Antes de tocar nada: copia de seguridad

Este paso no es negociable. Antes de cualquier migración:

1. Haz una copia completa de la base de datos de WHMCS.
2. Haz una copia de todos los archivos de la instalación (incluida la carpeta de configuración y los archivos personalizados).
3. Verifica que la copia es restaurable antes de continuar.

Si algo sale mal, esta copia es lo único que te permite volver atrás sin perder a tus clientes.

Pasos de la migración

1. Descarga el script de migración correspondiente desde tu área de clientes de WHMCS.
2. Instala WHMCS v6 en su ubicación.
3. Mueve includes/functions.php a includes/functions.backup.php (haces una copia de seguridad del original).
4. Copia el includes/functions.php de tu WHMCS v5 a la nueva instalación de v6 (mismo nombre de archivo).
5. Descomprime y ejecuta el script de migración en la nueva instalación v6, desde el directorio de WHMCS, lanzándolo desde el navegador.
6. Elimina el script de migración cuando termine y restaura functions.php desde la copia (functions.backup.php).

Hecho esto, comprueba que clientes, facturas, productos y dominios están completos y que la facturación automática vuelve a funcionar.

Una nota para 2025-2026

Conviene tenerlo claro: WHMCS v6 es una versión muy antigua y, a estas alturas, WHMCS ha publicado muchas versiones posteriores. Si todavía corres una v5 o v6, no deberías quedarte ahí: lo recomendable es planificar la actualización hasta la última versión estable soportada, por seguridad y compatibilidad. El procedimiento general no cambia tanto (copia de seguridad, actualizar, verificar), pero las versiones modernas se actualizan principalmente desde el propio panel o reemplazando archivos, sin necesidad de los scripts de fusión de antaño. Revisa siempre la guía de actualización oficial de la versión concreta a la que vas a saltar, porque hay saltos que requieren pasos intermedios y comprobaciones de requisitos de PHP.

Conclusión

Migrar WHMCS es totalmente viable si vas con orden: copia de seguridad primero, sigue los pasos del script oficial y verifica los datos al final. Y si prefieres no jugártela con la facturación de tu negocio, en TePublico.NET te echamos una mano con el mantenimiento web y el alojamiento web y hosting. Cuéntanos qué necesitas y lo vemos.