Cómo instalar Magento 2 (2026): Guía de configuración completa para principiantes - ES

Magento es una de las plataformas de comercio electrónico más poderosas disponibles. Pero instalarlo? Ahí es donde la mayoría de la gente se queda estancada. A diferencia de plataformas más simples, Magento necesita configuraciones de servidor específicas, los motores de búsqueda, y cuidadosa configuración. saltar un paso, y pasarás horas solucionando problemas.

Esta guía lo guiará a través de todo Magento 2 proceso de instalación. Aprenderá lo que necesita su servidor, cómo instalar usando Composer (el método recomendado), y como configurar todo correctamente. Ya sea que esté configurando un entorno de desarrollo o una tienda de producción, estos pasos aplican.

Una nota rápida sobre las versiones.: Código abierto de Magento 2.4.8 es la versión actual. Adobe cambió el nombre de Magento Commerce a Adobe Commerce, pero la versión de código abierto sigue siendo gratuita. Esta guía cubre tanto, aunque el proceso de instalación es casi idéntico.

Última actualización: febrero 2026. Todos los requisitos y comandos verificados con la documentación actual..

Requisitos del sistema Magento

Magento necesita muchos recursos. No funcionará en alojamiento compartido barato. Antes de que empieces, Confirme que su servidor cumple con estos requisitos..

Sistema operativo

Magento requiere Linux x86-64. Ubuntu 22.04 o 24.04 LTS, RHEL, CentOS, y Debian todos funcionan. Windows y macOS no son compatibles con la producción. Puedes usar macOS para el desarrollo local, pero no lo implementes.

Servidor web

Necesitas Apache 2.4 o nginx 1.18 (o más tarde). Apache requiere mod_rewrite habilitado. A menudo se prefiere Nginx por su rendimiento, pero ambos funcionan bien. Elija según su familiaridad.

Requisitos de PHP

Magento 2.4.7 y 2.4.8 requiere PHP 8.1 o 8.2. Las versiones anteriores no funcionarán. También necesitarás tener instaladas extensiones PHP específicas.:

• ext-bcmath
• tipo-ext
• ext-rizo
• ex-dom
• ext-gd
• ext-intl
• cadena-mb-ext
• ext-openssl
• ext-pdo_mysql
• jabón ext
• ext-xsl
• ext-zip
• enchufes externos

La configuración de PHP también importa. Colocar memory_limit a al menos 2GB. Aumentar max_execution_time a 18000 para instalación. Habilitar OPcache (un refuerzo de rendimiento de PHP) para una ejecución más rápida.

Base de datos

Magento 2.4.7 y luego requiere MySQL 8.0 o MariaDB 10.4 (o mas alto). Las versiones anteriores de MySQL no funcionarán. La base de datos necesita soporte del motor de almacenamiento InnoDB y codificación UTF-8 adecuada..

Buscador (Requerido)

Esto es lo que hace tropezar a muchas personas: Magento 2.4+ requiere un motor de búsqueda. MySQL ya no maneja búsquedas en catálogos. Debes instalar cualquiera de los dos:

• búsqueda elástica 7.17 o 8.x
• Abrir búsqueda 1.2 o 2.x (una bifurcación de Elasticsearch, totalmente compatible)

Se recomienda OpenSearch para nuevas instalaciones. Es de código abierto y recibe actualizaciones periódicas.. Cubriremos su instalación más adelante..

Requisitos adicionales

• Compositor 2.2+ – Administrador de dependencias de PHP (requerido para la instalación)
• RAM – Mínimo 2GB, 4GB recomendado
• Almacenamiento – Al menos 10 GB de SSD (Preferiblemente NVMe)
• Certificado SSL – Requerido para HTTPS (autofirmado no funcionará)
• TLS 1.2 – Requerido para acceder al repositorio de PayPal y Magento

Alojamiento recomendado

Hosting compartido no funcionará para Magento. Necesitas un VPS o servidor dedicado con acceso root completo. Espere gastar al menos entre 20 y 50 dólares al mes para obtener recursos adecuados. Para tiendas de mucho tráfico, servidores dedicados o alojamiento en la nube proporcionar una mejor escalabilidad.

Preinstalación: Preparación del servidor

Antes de instalar Magento, su servidor necesita una configuración adecuada. Estos pasos asumen Ubuntu 22.04, pero los comandos son similares para otras distribuciones.

Paso 1: Actualice su sistema

Comience con una nueva actualización del sistema:

sudo apt update && sudo apt upgrade -y

Paso 2: Instale PHP y las extensiones requeridas

Agregue el repositorio de PHP e instale PHP 8.2 con todas las extensiones requeridas:

sudo add-apt-repository ppa:ondrej/php -y
sudo apt update
sudo apt install php8.2 php8.2-fpm php8.2-mysql php8.2-xml php8.2-curl php8.2-gd php8.2-intl php8.2-mbstring php8.2-soap php8.2-xsl php8.2-zip php8.2-bcmath php8.2-sockets -y

Paso 3: Configurar los ajustes de PHP

Edite su archivo de configuración PHP:

sudo nano /etc/php/8.2/fpm/php.ini

Encuentra y modifica estos valores.:

memory_limit = 2G
max_execution_time = 18000
zlib.output_compression = On

Reiniciar PHP-FPM (Administrador de procesos PHP FastCGI) para aplicar cambios:

sudo systemctl restart php8.2-fpm

Paso 4: Instalar MySQL 8.0

sudo apt install mysql-server -y
sudo mysql_secure_installation

Crear una base de datos y un usuario para Magento:

sudo mysql -u root -p

CREATE DATABASE magento2;
CREATE USER 'magento_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON magento2.* TO 'magento_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Paso 5: Instalar Nginx

sudo apt install nginx -y
sudo systemctl enable nginx

Paso 6: Instalar Composer

Composer maneja las dependencias de Magento. Instálalo globalmente:

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
composer --version

Verificar compositor 2.2+ esta instalado. Las versiones anteriores causan problemas de dependencia.

Paso 7: Instalar OpenSearch

OpenSearch requiere Java. Instale OpenJDK primero:

sudo apt install openjdk-11-jdk -y

Agregue el repositorio OpenSearch e instálelo:

curl -o- https://artifacts.opensearch.org/publickeys/opensearch.pgp | sudo apt-key add -
echo "deb https://artifacts.opensearch.org/releases/bundle/opensearch/2.x/apt stable main" | sudo tee /etc/apt/sources.list.d/opensearch-2.x.list
sudo apt update
sudo env OPENSEARCH_INITIAL_ADMIN_PASSWORD=YourSecurePassword123! apt install opensearch -y

Configurar OpenSearch editando /etc/opensearch/opensearch.yml:

cluster.name: magento2
network.host: localhost
http.port: 9200
discovery.type: single-node
plugins.security.disabled: true

Iniciar y habilitar el servicio.:

sudo systemctl enable opensearch
sudo systemctl start opensearch

Verifique que esté funcionando:

curl -X GET "localhost:9200"

Deberías ver una respuesta JSON con información del clúster..

Instalación de Magento a través de Composer

El método Composer es el único método de instalación recomendado. Maneja las dependencias correctamente y simplifica las actualizaciones.. Evite descargas de archivos o clones de Git para sitios de producción.

Paso 1: Obtenga claves de autenticación de Magento

Necesita claves de autenticación para descargar Magento. Crea una cuenta gratuita en mercado.magento.com, entonces:

1. Go to My Profile > Access Keys
2. Hacer clic “Crear una nueva clave de acceso”
3. Nómbralo (p.ej, “Instalación del servidor”)
4. Copiar la clave pública (nombre de usuario) y clave privada (contraseña)

Guarde estas claves en el archivo de autenticación global de Composer:

composer global config http-basic.repo.magento.com <public_key> <private_key>

Paso 2: Crear el directorio web

Crea y navega hasta tu raíz web:

sudo mkdir -p /var/www/magento2
cd /var/www/magento2

Paso 3: Descargar Magento

Ejecute el comando de creación de proyecto de Composer. Para código abierto de Magento:

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

Para Adobe Comercio (versión paga):

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition .

Esto descarga más de 300 MB de archivos.. Ser paciente.

Paso 4: Establecer permisos de archivo

Los permisos adecuados impiden “Acceso denegado” errores y problemas de seguridad:

sudo find var generated vendor pub/static pub/media app/etc -type f -exec chmod 644 {} \;
sudo find var generated vendor pub/static pub/media app/etc -type d -exec chmod 755 {} \;
sudo chown -R www-data:www-data /var/www/magento2
sudo chmod u+x bin/magento

Paso 5: Ejecute el comando de instalación

Ahora ejecute la instalación real.. Personalice estos parámetros para su configuración:

bin/magento setup:install \
  --base-url="https://yourdomain.com/" \
  --db-host="localhost" \
  --db-name="magento2" \
  --db-user="magento_user" \
  --db-password="your_strong_password" \
  --admin-firstname="Admin" \
  --admin-lastname="User" \
  --admin-email="[email protected]" \
  --admin-user="admin" \
  --admin-password="Admin123!" \
  --language="en_US" \
  --currency="USD" \
  --timezone="America/New_York" \
  --use-rewrites=1 \
  --search-engine="opensearch" \
  --opensearch-host="localhost" \
  --opensearch-port="9200"

La instalación lleva 5-15 minutos dependiendo de la velocidad del servidor. Esté atento a cualquier error.

Cuando esté completo, Verás un mensaje con tu URL de administrador.. Es aleatorio por seguridad. (p.ej, /admin_abc123). Escribe esto.

Paso 6: Ejecutar comandos posteriores a la instalación

Complete la configuración con estos comandos esenciales:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

los static-content:deploy El comando genera archivos CSS y JavaScript.. los -f La bandera fuerza el despliegue en modo desarrollador..

Configurando Nginx para Magento

Magento necesita una configuración específica de Nginx. Crear un nuevo bloque de servidor:

sudo nano /etc/nginx/sites-available/magento2

Añade esta configuración (ajustar dominio y rutas):

upstream fastcgi_backend {
    server unix:/var/run/php/php8.2-fpm.sock;
}

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;

    set $MAGE_ROOT /var/www/magento2;
    set $MAGE_MODE production;

    include /var/www/magento2/nginx.conf.sample;
}

Habilite el sitio y pruebe la configuración.:

sudo ln -s /etc/nginx/sites-available/magento2 /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Magento proporciona una configuración de Nginx de muestra en nginx.conf.sample. La directiva de inclusión anterior la usa directamente.

Configurar trabajos cron

Magento depende en gran medida de los trabajos cron (tareas programadas) para indexar, correos electrónicos, mapas del sitio, y más. Sin cron, tu tienda no funcionará correctamente.

Ejecute este comando para generar las entradas de crontab:

bin/magento cron:install

Esto agrega tres trabajos cron. Verificar que existen:

crontab -l

Deberías ver entradas ejecutándose cada minuto para las tareas programadas de Magento..

Optimización del rendimiento: Redis y barniz

Una tienda Magento de producción necesita almacenamiento en caché para un rendimiento aceptable. Redis maneja sesiones y caché de backend. Barniz (un acelerador HTTP) maneja el almacenamiento en caché de página completa.

Instalación de Redis

sudo apt install redis-server -y
sudo systemctl enable redis-server

Verifique que Redis esté funcionando:

redis-cli ping

Debe responder con “APESTAR”.

Configure Magento para usar Redis para el almacenamiento en caché:

bin/magento setup:config:set --cache-backend=redis --cache-backend-redis-server=127.0.0.1 --cache-backend-redis-db=0
bin/magento setup:config:set --page-cache=redis --page-cache-redis-server=127.0.0.1 --page-cache-redis-db=1
bin/magento setup:config:set --session-save=redis --session-save-redis-host=127.0.0.1 --session-save-redis-db=2

Usando bases de datos separadas (0, 1, 2) mantiene aislados los diferentes tipos de caché.

Instalación de barniz

Varnish se encuentra frente a su servidor web y almacena en caché las páginas:

sudo apt install varnish -y

Magento genera el archivo de configuración de Varnish:

bin/magento varnish:vcl:generate --backend-host=localhost --backend-port=8080 --output-file=/etc/varnish/default.vcl

Necesitarás ajustar Nginx para escuchar en el puerto 8080 internamente mientras Varnish maneja el puerto 80. Esta configuración requiere una configuración adicional que va más allá del alcance de esta guía., pero la documentación de Magento lo cubre a fondo.

Configuración de seguridad

Proteger Magento requiere varios pasos. No te saltes estos.

Seguridad del panel de administración

Log into the Magento admin panel and navigate to Stores > Configuration > Advanced > Admin.

Bajo seguridad, configurar estos ajustes:

• Compartir cuenta de administrador: Empezar a “No” (evita que varias personas utilicen un mismo inicio de sesión)
• Duración de la contraseña: Empezar a 90 dias
• Máximo de errores de inicio de sesión: Empezar a 5
• Tiempo de bloqueo: Empezar a 30 minutos

Autenticación de dos factores

Magento 2.4+ permite la autenticación de dos factores (2FA) por defecto. Esto agrega un segundo paso de verificación más allá de las contraseñas.. No puedes desactivarlo, así que configúrelo correctamente:

1. Go to Stores > Configuration > Security > 2FA
2. Habilitar el autenticador de Google (u otro proveedor compatible)
3. En el primer inicio de sesión, escanea el código QR con tu aplicación de autenticación

Permisos de archivos

Después de la instalación, apretar los permisos:

sudo find /var/www/magento2 -type d -exec chmod 755 {} \;
sudo find /var/www/magento2 -type f -exec chmod 644 {} \;
sudo chmod -R 770 /var/www/magento2/var
sudo chmod -R 770 /var/www/magento2/pub/static
sudo chmod -R 770 /var/www/magento2/pub/media
sudo chmod -R 770 /var/www/magento2/generated

URL de administrador

Magento genera una URL de administrador aleatoria durante la instalación. Mantenlo así. No lo cambies a algo predecible como /admin. Si necesitas encontrarlo más tarde:

bin/magento info:adminuri

Configuración SSL/HTTPS

Utilice siempre HTTPS en producción. Después de instalar un certificado SSL (Let's Encrypt es gratis), configurar magento:

bin/magento setup:store-config:set --base-url="https://yourdomain.com/"
bin/magento setup:store-config:set --base-url-secure="https://yourdomain.com/"
bin/magento setup:store-config:set --use-secure=1
bin/magento setup:store-config:set --use-secure-admin=1
bin/magento cache:flush

Solución de problemas comunes de instalación

Incluso con una configuración cuidadosa, los problemas suceden. Estos son los problemas y soluciones más comunes..

Instalación atascada en 70%

Esto generalmente significa PHP max_execution_time es demasiado bajo. Edite php.ini y configúrelo en 18000, luego reinicie PHP-FPM. Alternativamente, ejecute la instalación a través de la línea de comando en lugar del instalador web.

“La clase no existe” Errores

Estos errores de ReflectionException indican archivos generados corruptos. Limpiarlos:

rm -rf var/cache var/page_cache var/generation generated/code
bin/magento setup:di:compile
bin/magento cache:flush

Errores de permiso denegado

Los permisos de archivos causan aproximadamente 38% de fallos de instalación. Asegúrese de que el usuario del servidor web (www-datos en Ubuntu) posee todos los archivos:

sudo chown -R www-data:www-data /var/www/magento2

Falta la extensión PHP

Mensajes de error como “Falta la extensión PHP solicitada ext-mbstring” significa que necesitas instalar esa extensión:

sudo apt install php8.2-mbstring -y
sudo systemctl restart php8.2-fpm

Error de conexión de Elasticsearch/OpenSearch

Si Magento no puede conectarse a su motor de búsqueda:

1. Compruebe si el servicio se está ejecutando: sudo systemctl status opensearch
2. Probar conectividad: curl localhost:9200
3. Verifique que las reglas del firewall no estén bloqueando el puerto 9200
4. Verifique que el nombre de host y el puerto en su comando de instalación coincidan con su configuración

Memoria agotada

Los errores de memoria de PHP durante la compilación significan que necesitas más RAM o espacio de intercambio:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

Páginas en blanco o 500 Errores

Habilite el modo de desarrollador para ver los errores reales:

bin/magento deploy:mode:set developer

Consulte los archivos de registro en var/log/exception.log y var/log/system.log para detalles.

Lista de verificación posterior a la instalación

Después de una instalación exitosa, completa estos pasos:

• Inicie sesión en el panel de administración y configure los ajustes de la tienda (nombre, zona horaria, moneda)
• Configurar métodos de envío
• Configurar pasarelas de pago
• Crear grupos de clientes y reglas fiscales.
• Configurar plantillas de correo electrónico y SMTP
• Configurar robots.txt y mapas de sitio
• Instalar extensiones esenciales a través de Composer
• Configurar copias de seguridad automáticas
• Cambiar al modo de producción: bin/magento deploy:mode:set production

Preguntas frecuentes

¿Puedo instalar Magento en hosting compartido??

Técnicamente si, pero no es recomendable. Magento requiere configuraciones PHP específicas, Acceso SSH, y compositor. La mayoría de los hosts compartidos no los proporcionan. También alcanzarás los límites de memoria rápidamente. Alojamiento VPS es la opción mínima práctica.

¿Cuánto tiempo lleva la instalación de Magento??

La preparación del servidor requiere 30-60 minutos si está familiarizado con Linux. La instalación real de Magento toma 10-20 minutos. Los usuarios nuevos deben hacer un presupuesto 2-4 horas para el proceso completo, incluida la resolución de problemas.

¿Necesito Elasticsearch u OpenSearch??

si, uno de ellos es obligatorio para Magento 2.4+. MySQL ya no maneja búsquedas en catálogos. OpenSearch es la opción recomendada para nuevas instalaciones ya que es completamente de código abierto y se mantiene activamente.

¿Cuál es la diferencia entre Magento Open Source y Adobe Commerce??

Magento Open Source es gratuito y cuenta con el respaldo de la comunidad. Adobe Commerce (anteriormente Magento Comercio) es la versión paga con características adicionales como funcionalidad B2B, herramientas de marketing avanzadas, y opciones de alojamiento en la nube. Adobe Commerce comienza en $22,000/año. Ambos comparten el mismo proceso de instalación..

¿Puedo migrar de WooCommerce a Magento??

si, pero requiere una planificación cuidadosa. Necesitarás exportar productos, clientes, y pedidos de WooCommerce e importarlos a Magento. Existen varias extensiones de migración, aunque las tiendas complejas pueden necesitar un desarrollo personalizado. Considere contratar un especialista en Magento para catálogos grandes.

¿Cómo actualizo Magento después de la instalación??

Utilice Composer para actualizar: composer update magento/product-community-edition --with-all-dependencies. Siempre haga una copia de seguridad de su base de datos y archivos primero. Pruebe las actualizaciones en un entorno de prueba antes de la producción. Correr bin/magento setup:upgrade después de actualizar.

¿Por qué mi tienda Magento va lenta??

Magento sin caché es lento por diseño. Genera páginas dinámicamente.. Habilite Redis para el almacenamiento en caché de backend y Varnish para el almacenamiento en caché de página completa. Habilitar modo de producción, que precompila el código. Utilizar una CDN para activos estáticos. Considere actualizar su recursos del servidor si el tráfico es alto.