cPanel & WHM es el panel de control más utilizado en la industria del web hosting. Si tienes un servidor dedicado o VPS con Webzi (o cualquier otro proveedor), esta guía te muestra cómo instalar cPanel desde cero en los sistemas operativos compatibles actualmente.

⚠️ Importante: cPanel debe instalarse en un sistema operativo limpio (minimal), sin Apache, Nginx, MySQL ni ningún otro panel de control preinstalado. cPanel instala y administra sus propios servicios durante el proceso.

Sistemas operativos compatibles

A la fecha, cPanel & WHM es compatible con las siguientes distribuciones Linux para nuevas instalaciones:

⚠️ CentOS 7 ya no es compatible con nuevas instalaciones de cPanel. Si tu servidor aún utiliza CentOS 7, deberás migrar a AlmaLinux o Rocky Linux. cPanel ofrece la herramienta ELevate para facilitar este proceso.

Requisitos previos

• Acceso SSH root al servidor.
• Sistema operativo limpio (instalación minimal, sin servicios web preinstalados).
• Mínimo: 1 GB RAM, 20 GB de disco (recomendado: 2+ GB RAM, SSD/NVMe).
• IP estática (las IPs asignadas por DHCP no son compatibles).
• Hostname FQDN válido (ejemplo: server.tudominio.com), que resuelva a la IP del servidor y no coincida con ningún dominio que vayas a alojar.
• Licencia cPanel válida (puedes usar un trial gratuito de 15 días para la primera instalación).

Paso 1: Conectar vía SSH

Conéctate a tu servidor utilizando Terminal (Linux/macOS) o PuTTY (Windows):

ssh root@tu-ip-del-servidor

Paso 2: Configurar el hostname

Establece un hostname FQDN válido. Este nombre debe ser un subdominio que resuelva a la IP de tu servidor (por ejemplo: server.tudominio.com):

hostnamectl set-hostname server.tudominio.com

Paso 3: Actualizar el sistema operativo

Antes de instalar cPanel, asegúrate de que todos los paquetes estén actualizados:

AlmaLinux / Rocky Linux / CloudLinux:

dnf update -y

Ubuntu 22.04 LTS:

apt update && apt upgrade -y

Paso 4: Desactivar SELinux (solo distribuciones RHEL)

cPanel no es compatible con SELinux. Debes desactivarlo antes de la instalación. Este paso no aplica para Ubuntu.

Desactívalo temporalmente:

setenforce 0

Desactívalo permanentemente:

sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config

Paso 5: Configurar el Network Manager

El manejo del Network Manager varía según la versión del sistema operativo:

AlmaLinux 8 / Rocky Linux 8 / CloudLinux 8 — Desactivar:

En las versiones 8, el instalador de cPanel desactiva el Network Manager automáticamente y habilita network.service. Sin embargo, para evitar problemas durante la instalación, se recomienda hacerlo manualmente:

systemctl stop NetworkManager.service && systemctl disable NetworkManager.service

AlmaLinux 9 / Rocky Linux 9 / CloudLinux 9 — No desactivar:

En las versiones 9, el Network Manager permanece habilitado y es el gestor de red predeterminado. No lo desactives, ya que cPanel lo requiere en estas versiones.

Ubuntu 22.04 LTS:

Ubuntu utiliza netplan como gestor de red. No necesitas hacer ningún cambio.

Paso 6: Desactivar el firewall (temporal)

Durante la instalación, cPanel necesita acceso sin restricciones a la red. Desactiva temporalmente el firewall:

AlmaLinux / Rocky Linux / CloudLinux:

systemctl stop firewalld && systemctl disable firewalld

Ubuntu 22.04 LTS:

ufw disable

ℹ️ Nota: Después de la instalación, se recomienda instalar un firewall como CSF (ConfigServer Security & Firewall) en lugar de reactivar el firewall nativo del sistema, ya que CSF está diseñado para trabajar en conjunto con cPanel.

Paso 7: Preconfigurar MySQL 8.4 (opcional pero recomendado)

Por defecto, cPanel instala MySQL 8.0. Si deseas que la instalación utilice MySQL 8.4 desde el inicio, debes crear un perfil de configuración antes de ejecutar el instalador:

mkdir /root/cpanel_profile

echo "mysql-version=8.4" > /root/cpanel_profile/cpanel.config

También puedes especificar otras versiones según tus necesidades:

⚠️ Importante: Este paso debe realizarse antes de ejecutar el instalador de cPanel. Si ya instalaste cPanel con otra versión de MySQL, el cambio deberá realizarse posteriormente desde WHM. Más información en la documentación oficial de cPanel.

Paso 8: Instalar herramientas necesarias e iniciar screen

Instala las herramientas básicas necesarias y usa screen o tmux para que la instalación continúe aunque se pierda la conexión SSH:

AlmaLinux / Rocky Linux / CloudLinux:

dnf install -y perl curl wget screen screen

Ubuntu 22.04 LTS:

apt install -y perl curl wget screen screen

ℹ️ Tip: Si pierdes la conexión SSH durante la instalación, reconecta y ejecuta screen -r para volver a la sesión donde se está ejecutando el instalador.

Paso 9: Ejecutar el instalador de cPanel

Este comando es el mismo para todas las distribuciones compatibles:

cd /home && curl -o latest -L https://securedownloads.cpanel.net/latest && sh latest

La instalación puede tardar entre 20 y 60 minutos dependiendo de los recursos del servidor y la velocidad de conexión. El progreso se registra en /var/log/cpanel-install.log.

ℹ️ Nota sobre CloudLinux: Si tu IP tiene una licencia de CloudLinux activa, el instalador de cPanel convertirá automáticamente el sistema operativo a CloudLinux. Si deseas evitar esta conversión y mantener AlmaLinux o Rocky Linux, utiliza la bandera --skip-cloudlinux al ejecutar el instalador.

Paso 10: Verificar la licencia

Si después de la instalación experimentas un error de licencia, actualízala con el siguiente comando:

/usr/local/cpanel/cpkeyclt

Paso 11: Acceder a WHM

Una vez completada la instalación, accede a WHM desde tu navegador:

https://tu-ip-del-servidor:2087

Inicia sesión con las credenciales de root del servidor. WHM te guiará a través del asistente de configuración inicial donde podrás:

• Aceptar los términos de licencia (o activar un trial de 15 días).
• Configurar la dirección de contacto del servidor.
• Establecer los nameservers.
• Habilitar AutoSSL con Let's Encrypt para certificados SSL automáticos.
• Crear paquetes de hosting y cuentas.

Puertos necesarios para cPanel

Si utilizas un firewall externo o reglas de seguridad en tu proveedor de cloud, asegúrate de que los siguientes puertos estén abiertos:

Resumen rápido de comandos (AlmaLinux 9 + MySQL 8.4)

Para una instalación completa en AlmaLinux 9 con MySQL 8.4, ejecuta los siguientes comandos en orden:

# Configurar hostname hostnamectl set-hostname server.tudominio.com # Actualizar sistema dnf update -y # Desactivar SELinux setenforce 0 sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config # Preconfigurar MySQL 8.4 mkdir /root/cpanel_profile echo "mysql-version=8.4" > /root/cpanel_profile/cpanel.config # Instalar herramientas e iniciar screen dnf install -y perl curl wget screen screen # Instalar cPanel cd /home && curl -o latest -L https://securedownloads.cpanel.net/latest && sh latest

Referencias

• Personalizar la versión de MySQL/MariaDB durante la instalación de cPanel
• ¿Qué versiones de PHP soporta cPanel?
• cPanel ELevate — Migración de CentOS 7

¿Necesitas ayuda?

Si tienes un VPS o servidor dedicado con Webzi y necesitas asistencia con la instalación o configuración de cPanel, nuestro equipo de soporte puede ayudarte:

• Abre un ticket de soporte desde tu panel My Webzi o escribiendo a soporte@webzi.mx
• Chat en vivo disponible en webzi.mx
• Consulta nuestra base de conocimientos: https://help.webzi.mx