Domina Joomla en Local con DDEV: La Guía "A prueba de fallos"

Si alguna vez has intentado montar un servidor local (como XAMPP o WAMP) y has acabado peleándote con versiones de PHP o bases de datos que no conectan, este tutorial es para ti. Hoy vamos a usar DDEV, una herramienta moderna que hace que todo funcione "como por arte de magia" usando Docker.

No necesitas ser un experto en sistemas. Solo sigue estos pasos y tendrás tu entorno de desarrollo profesional listo en minutos.

Parte 1: Instalación de lo Básico

Antes de empezar, necesitamos dos ingredientes: el motor (Docker) y la herramienta de control (DDEV).

1. Instala Docker

Docker es la tecnología que permite crear "contenedores" aislados para tus webs. No necesitas saber cómo funciona, solo instalarlo.

• En Linux (Ubuntu/Debian): Abre tu terminal y busca cómo instalar docker.io, o descarga Docker Desktop para Linux.
• ¡Importante!: Si estás en Linux, asegúrate de que tu usuario tiene permisos. Ejecuta esto una sola vez en tu terminal:

sudo usermod -aG docker $USER
newgrp docker

2. Instala DDEV

Ahora instalamos la estrella del show. Abre tu terminal y pega este comando:

curl -fsSL https://ddev.com/install.sh | bash

Una vez termine, ejecuta este comando para que tu navegador confíe en los certificados de seguridad (así tendrás el candadito verde 🔒 en local):

mkcert -install

Parte 2: Cómo instalar un Joomla Limpio (Desde Cero)

Vamos a crear tu primera web. Imagina que quieres hacer un proyecto llamado "mi-blog".

Paso 1: Crea la carpeta y configura

Abre la terminal y ejecuta estas órdenes:

mkdir mi-blog
cd mi-blog
ddev config --project-type=php --docroot="" --create-docroot
ddev start

Paso 2: Descarga Joomla automáticamente

Sin salir de la terminal, vamos a bajar la última versión de Joomla:

wget https://downloads.joomla.org/cms/joomla5/5-2-5/Joomla_5-2-5-Stable-Full_Package.zip
unzip Joomla_5-2-5-Stable-Full_Package.zip
rm Joomla_5-2-5-Stable-Full_Package.zip

Paso 3: Instala en el navegador

Lanza la web con el comando:

ddev launch

Sigue los pasos del instalador de Joomla. ¡OJO! Este es el punto más importante. Cuando te pida la base de datos, usa estos datos:

• Hospedaje (Host): db
• Usuario: db
• Contraseña: db
• Base de datos: db

¡Listo! Ya tienes un Joomla 5 virgen funcionando.

Parte 3: Cómo instalar un "Quickstart" (Plantilla con datos)

¿Has comprado una plantilla profesional y viene con un archivo Quickstart? Es muy fácil de instalar.

1. Crea una carpeta nueva (ej: mi-plantilla) y entra en ella.
2. Inicia DDEV: ddev config --project-type=php --docroot="" --create-docroot y luego ddev start.
3. Copia el archivo .zip de tu Quickstart dentro de esa carpeta.
4. Descomprímelo (click derecho "Extraer aquí" o usando unzip nombre-archivo.zip).
5. Ejecuta ddev launch.

Se abrirá el instalador de Joomla. Recuerda usar siempre los datos de base de datos: db / db / db / db.

Parte 4: Restaurar una copia de Akeeba Backup (.JPA)

Si quieres traer una web que ya tienes online a tu ordenador local, Akeeba Backup es la mejor opción.

Paso 1: Prepara el terreno

1. Crea tu carpeta (ej: web-restaurada).
2. Configura y arranca: ddev config --project-type=php --docroot="" --create-docroot y ddev start.

Paso 2: Pon los archivos necesarios

Necesitas poner dos archivos dentro de tu carpeta:

• Tu archivo de copia de seguridad (extensión .jpa).
• El archivo kickstart.php (lo puedes descargar gratis de la web de Akeeba).

Paso 3: Ejecuta el Kickstart

En tu terminal, escribe:

ddev launch /kickstart.php

Esto abrirá la herramienta de restauración:

1. Sigue los pasos para extraer el archivo.
2. Cuando te pida la conexión a la base de datos, recuerda: Servidor = db, Usuario = db, Clave = db, Base de datos = db.
3. Sigue hasta el final y limpia la carpeta de instalación cuando te lo pida.

Trucos Finales para el Día a Día

• ¿Cómo apago la web? Entra en la carpeta y escribe ddev stop.
• ¿Cómo veo todas mis webs? Escribe ddev list.
• ¿Cómo apago TODO antes de dormir? Escribe ddev poweroff (esto libera toda la memoria RAM de tu PC).

¡Ahora ya no tienes excusa para no probar cosas nuevas en Joomla desde la seguridad de tu propio ordenador!