Cómo instalar Drupal CMS con DDEV (sin ser experto)

Instala Drupal CMS con DDEV (sin ser experto)

Esta guía te ayudará a instalar DDEV y configurar un entorno local de Drupal CMS en Windows (WSL2 + Ubuntu) y macOS de manera sencilla y eficiente.

Guía para Windows (WSL2 + Ubuntu)

Paso 1: Instalar WSL2 y Ubuntu

WSL2 (Windows Subsystem for Linux) permite ejecutar un entorno Linux en Windows.

  • Abre PowerShell como administrador.
  • Escribe el siguiente comando y presiona Enter:
wsl --install -d Ubuntu
  • Espera a que se instale Ubuntu y reinicia tu computadora si es necesario.
  • Abre Ubuntu desde el menú de inicio y sigue las instrucciones para crear un usuario y una contraseña.
  • Una vez dentro de Ubuntu, ejecuta:
sudo apt update && sudo apt upgrade -y
Paso 2: Instalar Docker Desktop

Docker es necesario para que DDEV funcione correctamente.

  • Descarga Docker Desktop desde su sitio web.
  • Instálalo y, cuando termine, abre Docker Desktop.
    • Ve a Settings → General y activa "Use the WSL 2 based engine".
    • Luego, ve a Resources → WSL Integration y asegúrate de que Ubuntu esté activado.
  • Reinicia tu computadora para aplicar los cambios.
  • Después de reiniciar, abre Docker Desktop manualmente para que comience a funcionar.
Paso 3: Instalar DDEV

DDEV es una herramienta que simplifica la configuración de entornos de desarrollo locales.

  • Abre Ubuntu y ejecuta estos comandos:
sudo apt update && sudo apt upgrade -y
sudo apt install -y bash-completion
curl -fsSL https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh | bash
  • Cuando termine, verifica que DDEV está instalado ejecutando (si ves un número de versión significa que se instaló correctamente):
ddev --version
Paso 4: Configurar Drupal CMS con DDEV
  • Crea un directorio para el proyecto y accede a él:
mkdir my-drupal-site && cd my-drupal-site
  • Configura el proyecto en DDEV:
ddev config
  • Se te harán algunas preguntas:
    • Docroot Location: Escribe web y presiona Enter.
    • Project Type: Escribe drupal y presiona Enter.
    • Project Name: Puedes poner starshot-site o cualquier otro nombre que prefieras.
  • Inicia DDEV:
ddev start

En algunos casos, pueden aparecer las siguientes preguntas:

  1. "DDEV needs to add your user to the 'docker' group. Do you want to proceed? (y/N)" Si ves esta pregunta, responde "y" (yes) y presiona Enter. Esto permitirá que DDEV use Docker sin requerir permisos adicionales.
  2. "It looks like you have a new DDEV release. May we send anonymous DDEV usage statistics and errors?" DDEV puede solicitar permiso para enviar estadísticas de uso anónimas y datos de errores. Si prefieres compartir esta información, responde "y" (yes); si no, responde "N" (no).

💡 Si ves un error con stability stable, ignóralo y ejecuta ddev start nuevamente. Si el sitio carga correctamente, puedes continuar.

  • Instalar Drupal. Este comando descargará y configurará Drupal en tu computadora:
ddev composer create drupal/cms
  • Abrir el sitio en el navegador:
ddev launch

Si aparece un error con xdg-open, instala el paquete con:

sudo apt install xdg-utils -y

Luego intenta ddev launch nuevamente.

Si ddev launch no abre el sitio automáticamente, copia el enlace que aparece en ddev status y pégalo manualmente en tu navegador.

Guía para macOS

Paso 1: Instalar Homebrew

Homebrew facilita la instalación de paquetes en macOS.

  • Abre Terminal y ejecuta:
/bin/bash -c "$(curl -fsSL

https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • Una vez instalado, actualiza Homebrew:
brew update
Paso 2: Instalar Docker Desktop
  • Descarga Docker Desktop desde su sitio web.
  • Instálalo y asegúrate de que Docker esté corriendo.
  • Después de reiniciar la computadora, abre Docker Desktop manualmente para que comience a funcionar.
Paso 3: Instalar DDEV
  • En Terminal, ejecuta:
brew install drud/ddev/ddev
  • Verifica que DDEV está instalado con:
ddev --version
Paso 4: Configurar Drupal CMS con DDEV
  • Crea un directorio para el proyecto y accede a él:
mkdir my-drupal-site && cd my-drupal-site
  • Configura el proyecto en DDEV:
ddev config
  • Se te harán algunas preguntas:
    • Docroot Location: Escribe web y presiona Enter.
    • Project Type: Escribe drupal y presiona Enter.
    • Project Name: Puedes poner starshot-site o cualquier otro nombre que prefieras.
  • Inicia DDEV:
ddev start

Después de este comando, DDEV puede hacer algunas preguntas:

  1. "DDEV needs to add your user to the 'docker' group. Do you want to proceed? (y/N)" Si ves esta pregunta, responde "y" (yes) y presiona Enter. Esto permitirá que DDEV use Docker sin requerir permisos adicionales.
  2. "It looks like you have a new DDEV release. May we send anonymous DDEV usage statistics and errors?" DDEV puede solicitar permiso para enviar estadísticas de uso anónimas y datos de errores. Si prefieres compartir esta información, responde "y" (yes); si no, responde "N" (no).

💡 Si ves un error con stability stable, ignóralo y ejecuta ddev start nuevamente. Si el sitio carga correctamente, puedes continuar.

  • Instalar Drupal:
ddev composer create drupal/cms
  • Abrir el sitio en el navegador:
ddev launch

Si aparece un error con xdg-open, instala el paquete con:

sudo apt install xdg-utils -y

Luego intenta ddev launch nuevamente.

Si ddev launch no abre el sitio automáticamente, copia el enlace que aparece en ddev status y pégalo manualmente en tu navegador.

Notas finales

  • Para detener el entorno, usa:
ddev stop
  • Para volver a iniciarlo más tarde, usa:
ddev start

Siguiendo estos pasos, tendrás Drupal CMS funcionando en tu máquina local con DDEV listo para desarrollar.

mfernanda.silv… , 21.03.2025 | Enviado en
Innovación, Tecnología