Antes de empezar

WHMCS se instala como cualquier aplicación PHP clásica. Funciona sobre tu mismo plan de hosting, en un subdominio como my.tudominio.com o billing.tudominio.com. Antes de subir nada, asegúrate de tener lo siguiente en orden.

Requisitos técnicos

• PHP en una versión actualmente soportada por el instalador.
• Base de datos MySQL o MariaDB con un usuario dedicado.
• Extensiones PHP comunes: curl, gd, json, mbstring, openssl, pdo_mysql, xml y zip.
• Tu licencia de WHMCS activa, asociada al dominio donde lo instalarás.
• Un cliente FTP o acceso al administrador de archivos de cPanel.

Paso 1: crear la base de datos

En tu cPanel ingresa a la sección de bases de datos MySQL y crea una base nueva con un nombre claro, por ejemplo usuario_whmcs. Crea también un usuario de base de datos con una contraseña fuerte y asígnalo a esa base con todos los privilegios. Anota estos tres datos: nombre de la base, usuario y contraseña; los necesitarás en dos pasos más.

Paso 2: subir los archivos

Descarga el paquete de WHMCS desde el área de miembros donde compraste o activaste la licencia. Vas a recibir un archivo comprimido. Descomprímelo y sube el contenido de la carpeta interna (no la carpeta padre) al directorio donde quieras que viva la aplicación. Si vas a usar el subdominio my.tudominio.com, súbelo dentro de la carpeta que ese subdominio apunta en tu cPanel.

Renombrar el archivo de configuración

Dentro de los archivos subidos hay un configuration.php.new. Renómbralo a configuration.php. Déjalo vacío por ahora, el instalador lo llenará solo.

Paso 3: correr el instalador web

Abre en tu navegador la URL https://my.tudominio.com/install/install.php. Verás una pantalla de bienvenida con verificación de requisitos. Si alguno aparece en rojo, resuelve ese tema antes de avanzar (normalmente es una extensión PHP faltante; actívala desde "Select PHP Version" en cPanel).

El instalador te pedirá:

1. Aceptar los términos de licencia.
2. La clave de licencia que compraste.
3. Los datos de la base de datos que creaste en el paso 1.
4. Los datos del primer usuario administrador: nombre, correo y contraseña.

Pulsa continuar y en pocos segundos verás la pantalla de instalación completada.

Paso 4: limpiar después de instalar

El instalador deja dos tareas obligatorias que debes ejecutar apenas termines:

• Borrar la carpeta install: vía FTP o administrador de archivos, eliminala por completo. Si no lo haces, WHMCS se niega a funcionar.
• Renombrar la carpeta admin: por seguridad, cámbiale el nombre a algo único, por ejemplo panel o gestion2026. Luego abre configuration.php y agrega la línea $customadminpath = 'panel'; con el nombre nuevo.

Primer inicio de sesión

Entra a https://my.tudominio.com/panel/ con el usuario administrador que creaste. Vas a caer en el tablero principal. Desde aquí empezarás a configurar servidores, productos y pasarelas. Antes de seguir, recorre la sección de configuración general y llena los datos básicos de tu empresa: nombre, logo, correo remitente, zona horaria y moneda.