Cómo instalar WordPress con WP-CLI paso a paso

Normalmente puedes instalar WordPress descargando los archivos desde su web oficial y subiéndolos por FTP. Pero si realizas esta tarea a menudo, cualquier mejora en el tiempo que empleas es clave para trabajar de forma más eficiente.

Con WP-CLI puedes instalar WordPress en apenas cuatro comandos y sin necesidad de abrir el navegador. Sin asistente de instalación, sin descargas manuales, sin subidas por FTP. Es el método que usan los desarrolladores para aprovisionar instalaciones de WordPress de forma repetible y automatizable.

¿Qué es WP-CLI?

Si ya trabajas con servidores y terminal, sabrás lo útil que es automatizar tareas con la línea de comandos. WP-CLI es una utilidad pensada para WordPress que te permite ejecutar acciones rutinarias con un comando, en lugar de hacerlo desde el clásico wp-admin.

Consulta la guía WP-CLI: comandos básicos y ejemplos prácticos para una visión completa de lo que puedes hacer con WP-CLI más allá de la instalación.

Prerrequisitos

Antes de empezar, necesitas tener:

• Acceso SSH al servidor. Consulta la guía cómo acceder por SSH a tu hosting de Nicalia.
• Una base de datos MySQL creada en cPanel con su usuario y contraseña. Consulta las guías crear una base de datos en cPanel y crear un usuario MySQL.
• El dominio configurado y apuntando al servidor donde vas a instalar WordPress.

Guía paso a paso: instalar WordPress con WP-CLI

Paso 1 — Sitúate en la carpeta de instalación

Accede por SSH y navega a la carpeta donde quieres instalar WordPress. Por ejemplo, la raíz del dominio principal:

cd public_html/

ℹ️ Si WordPress va en un subdirectorio (ej: public_html/blog/), crea la carpeta primero con mkdir blog y luego navega a ella con cd blog/.

Paso 2 — Descarga el núcleo de WordPress

Para que la instalación no se realice en inglés, añade el parámetro --locale=es_ES:

wp core download --locale=es_ES

Este comando descarga la última versión estable de WordPress en español directamente desde wordpress.org al directorio actual.

Paso 3 — Genera el archivo wp-config.php

Ejecuta este comando sustituyendo los valores por los de tu base de datos:

wp core config --dbname=usuario_basededatos --dbuser=usuario_usuariobasededatos --dbpass=tuclave --dbhost=localhost --dbprefix=prefijo_

Parámetro	Descripción	Ejemplo
--dbname	Base de datos que vas a usar	--dbname=usuario_basededatos
--dbuser	Usuario MySQL para conectar	--dbuser=usuario_usuariobasededatos
--dbpass	Contraseña del usuario MySQL	--dbpass=tuclave
--dbhost	Servidor de la base de datos	--dbhost=localhost
--dbprefix	Prefijo para las tablas	--dbprefix=prefijo_

ℹ️ En los servidores de Nicalia, el nombre de la base de datos y el usuario incluyen el prefijo del usuario de cPanel (ej: cpanelusr_nombrebd). Puedes verlos en cPanel → Bases de datos MySQL.

Paso 4 — Ejecuta la instalación

Por último, ejecuta el comando de instalación con los datos de tu dominio y la cuenta de administrador:

wp core install --url=demo.nicalia.com --title="Nicalia" --admin_user=usuario_admin --admin_password=tu_clave --admin_email=correo@tudominio.com

Parámetro	Descripción	Ejemplo
--url	Dominio de tu web	--url=demo.nicalia.com
--title	Título del sitio	--title="Nicalia"
--admin_user	Usuario administrador	--admin_user=usuario_admin
--admin_password	Contraseña del administrador	--admin_password=tu_clave
--admin_email	Email del administrador	--admin_email=correo@tudominio.com

Si la instalación se completa correctamente, verás el mensaje Success: WordPress installed successfully. Tu WordPress estará listo en tudominio.com/wp-admin.

Instalar una versión específica de WordPress

Si por motivos de compatibilidad necesitas instalar una versión concreta de WordPress en lugar de la última disponible, añade el parámetro --version al comando de descarga:

wp core download --locale=es_ES --version=6.4.3

Puedes consultar el histórico de versiones disponibles en wordpress.org/download/releases.

Errores frecuentes al instalar WordPress con WP-CLI

«Error establishing a database connection» al ejecutar wp core install

Los datos de la base de datos en el paso 3 son incorrectos. Verifica que el nombre de la base de datos, el usuario y la contraseña son exactamente los que aparecen en cPanel → Bases de datos MySQL. Recuerda que en Nicalia el nombre incluye el prefijo del usuario de cPanel (ej: cpanelusr_mibd). También verifica que el usuario MySQL tiene permisos asignados sobre esa base de datos.

«wp: command not found»

WP-CLI no está disponible en el PATH del servidor. En los servidores de Nicalia, WP-CLI está disponible como comando wp. Si el comando no se encuentra, verifica que estás conectado por SSH y no por otro método. Si el problema persiste, consulta la guía cómo acceder por SSH para verificar la conexión.

Los archivos se descargan en la carpeta incorrecta

Verifica con pwd que estás en el directorio correcto antes de ejecutar wp core download. El comando descarga los archivos en el directorio actual — si estás en /home/usuario en lugar de /home/usuario/public_html, los archivos se instalarán en el lugar incorrecto.

«WordPress is already installed»

Ya hay una instalación de WordPress en ese directorio. Si quieres reinstalarla, primero elimina los archivos y la base de datos existentes, o usa un directorio diferente. Para sobrescribir los archivos del core sin tocar la base de datos puedes usar wp core download --force.

Preguntas frecuentes

¿Cómo instalar WordPress con WP-CLI desde SSH?

Conecta por SSH, navega a la carpeta de instalación (cd public_html/) y ejecuta los 4 comandos: (1) wp core download --locale=es_ES para descargar WordPress; (2) wp core config --dbname=... --dbuser=... --dbpass=... --dbhost=localhost para crear el wp-config.php; (3) wp core install --url=... --title=... --admin_user=... --admin_password=... --admin_email=... para ejecutar la instalación.

¿Necesito crear la base de datos antes de instalar con WP-CLI?

Sí. WP-CLI no crea la base de datos automáticamente — solo genera el wp-config.php con los datos que le indiques y ejecuta las tablas en una base de datos ya existente. Debes crear la base de datos y el usuario MySQL desde cPanel → Bases de datos MySQL antes del paso 3.

¿Cómo instalar WordPress en español con WP-CLI?

Añade el parámetro --locale=es_ES al comando de descarga: wp core download --locale=es_ES. Esto descarga directamente la versión en español de WordPress desde wordpress.org.

¿Puedo instalar una versión anterior de WordPress con WP-CLI?

Sí. Añade --version=X.X.X al comando de descarga: wp core download --locale=es_ES --version=6.4.3. Consulta el historial de versiones disponibles en wordpress.org/download/releases.

¿Cuál es la diferencia entre instalar WordPress con WP-CLI y con Softaculous?

Softaculous es una interfaz gráfica en cPanel que guía la instalación paso a paso — ideal para usuarios sin experiencia en terminal. WP-CLI es más rápido (todo en un único script si lo automatizas), más flexible (control total sobre cada parámetro) y no requiere navegador — ideal para desarrolladores que instalan múltiples WordPress repetidamente. Para una instalación puntual, Softaculous es perfectamente válido. Consulta la guía instalar WordPress con Softaculous.