Si eres desarrollador o trabajas en ecommerce, seguramente ya sabes que Magento 2 es una de las plataformas más potentes para tiendas online. Aunque está pensado para entornos Linux, muchos profesionales utilizan Mac para sus proyectos. En este artículo te explicamos cómo instalar Magento 2 en macOS, paso a paso, y te ayudamos a configurar un entorno de desarrollo local optimizado.

A lo largo del artículo usaremos herramientas como Homebrew, Composer, PHP y MySQL, necesarias para una correcta configuración de Magento 2 en Mac. Además, repasaremos los requisitos de Magento 2 en macOS, cómo crear un entorno local eficiente y qué aspectos debes tener en cuenta para que el proceso sea fluido y estable.

Requisitos previos para instalar Magento 2 en macOS

Antes de comenzar, asegúrate de tener lo siguiente:

  • Un equipo con macOS actualizado
  • Acceso a la terminal
  • Homebrew instalado
  • Conocimientos básicos de línea de comandos

Los requisitos de Magento 2 en macOS incluyen:

  • PHP 8.1 o 8.2 (según la versión de Magento 2)
  • MySQL 8.0
  • Composer (para gestionar dependencias)
  • Node.js y npm (para la parte frontend)

Cumplir con estos requisitos garantiza una correcta configuración de Magento 2 en Mac y reduce posibles errores durante la instalación.

 Paso 1: Instalar Homebrew y paquetes necesarios

Abre tu terminal y asegúrate de tener Homebrew:

/bin/bash -c «$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)»

 

Una vez instalado, ejecuta los siguientes comandos para instalar los paquetes clave para tu entorno local Magento 2:

brew install php mysql nginx composer

 

Con esto ya tienes la base para trabajar con PHP para Magento en Mac y MySQL para Magento 2 en Mac.

⚙️ Paso 2: Configurar PHP y MySQL para Magento 2

Configurar PHP

Magento 2 necesita una versión específica de PHP. Verifica la instalada:

php -v

 

Si necesitas cambiar la versión, puedes usar:

brew install php@8.1

brew link –overwrite –force php@8.1

 

Esto asegura una correcta instalación de PHP para Magento en Mac, compatible con la plataforma.

Configurar MySQL

Inicia el servicio de MySQL:

brew services start mysql

 

Y configura una nueva base de datos para Magento:

mysql -u root

CREATE DATABASE magento2;

 

La base de datos es un componente fundamental para el desarrollo Magento 2 en Mac.

 Paso 3: Instalar Composer y clonar Magento 2

Magento 2 requiere Composer para gestionar sus dependencias. Comprueba su instalación:

composer -V

 

Si no está instalado, usa:

brew install composer

 

Clona el repositorio de Magento 2:

composer create-project –repository-url=https://repo.magento.com/ magento/project-community-edition magento2

 

Durante este paso, necesitarás una cuenta en Magento Marketplace para obtener las claves de acceso. Composer es una herramienta esencial en el ecosistema de Magento, por lo que su correcta integración es clave para todo entorno local Magento 2.

 Paso 4: Configurar NGINX y entorno local

Instala y configura NGINX como servidor web:

brew install nginx

 

Edita el archivo de configuración para que apunte a tu carpeta Magento:

sudo nano /opt/homebrew/etc/nginx/nginx.conf

 

Agrega un bloque server para servir el contenido de Magento 2:

server {

    listen 80;

    server_name magento2.local;

    root /Users/tu-usuario/magento2/pub;

    index index.php index.html;

 

    location / {

        try_files $uri $uri/ /index.php$is_args$args;

    }

 

    location ~ \.php$ {

        include fastcgi_params;

        fastcgi_pass 127.0.0.1:9000;

        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

        fastcgi_index index.php;

    }

}

 

Modifica tu archivo /etc/hosts para enlazar magento2.local con tu IP local:

sudo nano /etc/hosts

 

Y añade:

127.0.0.1 magento2.local

 

Esto completa la configuración de tu entorno local Magento 2.

 Paso 5: Instalar Magento 2 desde el navegador

Con todo listo, abre tu navegador y visita:

http://magento2.local/setup

 

Sigue el asistente de instalación, completando con:

  • Nombre de la base de datos: magento2
  • Usuario: root
  • Contraseña: (vacío si no has definido una)

Tras completar los pasos, ya tendrás Magento 2 funcionando en tu Mac. ¡Enhorabuena! Has conseguido instalar Magento 2 en macOS correctamente.

 Siguientes pasos para desarrollo Magento 2 en Mac

Con tu entorno preparado, puedes comenzar a desarrollar extensiones, temas o integraciones personalizadas. Algunos consejos adicionales:

  • Usa bin/magento para comandos CLI

Habilita el modo desarrollador:

 bin/magento deploy:mode:set developer

  • Configura Git para llevar control de tus proyectos
  • Instala herramientas de depuración como Xdebug

El desarrollo Magento 2 en Mac puede ser igual de potente que en Linux si se configura bien desde el inicio.

¿Buscas ayuda profesional con Magento? Confía en Comonline

En Comonline somos expertos en soluciones Magento. Desde el desarrollo de tiendas online a medida hasta la optimización de rendimiento, nuestro equipo te acompaña en todo el proceso de digitalización. Trabajamos con empresas que buscan resultados reales, escalabilidad y crecimiento sostenible.

Además, si ya tienes tu entorno de desarrollo local pero necesitas un servidor de alto rendimiento, contamos con un hosting especializado para Magento, diseñado específicamente para ecommerce exigentes. Ofrecemos:

  • Infraestructura optimizada para Magento 2
  • Alta disponibilidad y seguridad
  • Soporte técnico especializado en ecommerce

 Conclusión

Instalar Magento 2 en macOS puede parecer complejo al principio, pero con esta guía paso a paso, puedes tener tu entorno listo para el desarrollo en menos tiempo del que imaginas. Con Composer, PHP, MySQL y NGINX bien configurados, podrás trabajar de forma local de manera profesional y eficiente.

Si necesitas ayuda para implementar Magento en tu empresa o llevar tu ecommerce al siguiente nivel, no dudes en contactarnos. En Comonline te ayudamos a transformar tu tienda online en una plataforma de alto rendimiento.