Como instalar o Magento 2 (2026): Guia de configuração completo para iniciantes - PT

Magento é uma das plataformas de comércio eletrônico mais poderosas disponíveis. Mas instalá-lo? É aí que a maioria das pessoas fica presa. Ao contrário de plataformas mais simples, Magento precisa de configurações de servidor específicas, motores de busca, e configuração cuidadosa. Pular uma etapa, e você passará horas solucionando problemas.

Este guia orienta você por todo o Magento 2 processo de instalação. Você aprenderá o que seu servidor precisa, como instalar usando o Composer (o método recomendado), e como configurar tudo corretamente. Esteja você configurando um ambiente de desenvolvimento ou uma loja de produção, estas etapas se aplicam.

Uma nota rápida sobre versões: Código aberto Magento 2.4.8 é a versão atual. Adobe renomeou Magento Commerce para Adobe Commerce, mas a versão de código aberto permanece gratuita. Este guia cobre ambos, embora o processo de instalação seja quase idêntico.

Última atualização: fevereiro 2026. Todos os requisitos e comandos verificados em relação à documentação atual.

Requisitos do sistema Magento

Magento precisa de recursos. Não funcionará em hospedagem compartilhada barata. Antes que você comece, confirme se seu servidor atende a esses requisitos.

Sistema operacional

Magento requer Linux x86-64. Ubuntu 22.04 ou 24.04 LTS, RHEL, CentOS, e Debian funcionam. Windows e macOS não são compatíveis com produção. Você pode usar o macOS para desenvolvimento local, mas não implante nele.

Servidor web

Você precisa do Apache 2.4 ou Nginx 1.18 (ou mais tarde). Apache requer mod_rewrite habilitado. Nginx é frequentemente preferido para desempenho, mas ambos funcionam bem. Escolha com base na sua familiaridade.

Requisitos de PHP

Magento 2.4.7 e 2.4.8 requer PHP 8.1 ou 8.2. Versões anteriores não funcionarão. Você também precisará de extensões PHP específicas instaladas:

• ext-bcmath
• ext-ctype
• ext-curl
• ext-dom
• ext-gd
• ext-intl
• ext-mbstring
• ext-openssl
• ext-pdo_mysql
• ext-sabonete
• ext-xsl
• ext-zip
• soquetes ext

A configuração do PHP também é importante. Definir memory_limit para pelo menos 2 GB. Aumentar max_execution_time para 18000 para instalação. Habilitar OPcache (um impulsionador de desempenho PHP) para uma execução mais rápida.

Base de dados

Magento 2.4.7 e mais tarde requerem MySQL 8.0 ou MariaDB 10.4 (ou mais alto). Versões anteriores do MySQL não funcionarão. O banco de dados precisa de suporte ao mecanismo de armazenamento InnoDB e codificação UTF-8 adequada.

Mecanismo de busca (Obrigatório)

Aqui está o que confunde muitas pessoas: Magento 2.4+ requer um mecanismo de pesquisa. MySQL não lida mais com pesquisas de catálogo. Você deve instalar:

• Elasticsearch 7.17 ou 8.x
• Pesquisa aberta 1.2 ou 2.x (um fork do Elasticsearch, totalmente compatível)

OpenSearch é recomendado para novas instalações. É de código aberto e recebe atualizações regulares. Abordaremos sua instalação mais tarde.

Requisitos Adicionais

• Compositor 2.2+ – Gerenciador de dependências PHP (necessário para instalação)
• RAM – Mínimo 2 GB, 4GB recomendado
• Armazenamento – SSD de pelo menos 10 GB (NVMe preferido)
• Certificado SSL – Obrigatório para HTTPS (autoassinado não funciona)
• TLS 1.2 – Necessário para acesso ao repositório PayPal e Magento

Hospedagem recomendada

Hospedagem Compartilhada não funcionará para Magento. Você precisa de um VPS ou servidor dedicado com acesso root completo. Espere gastar pelo menos US$ 20-50/mês para recursos adequados. Para lojas de alto tráfego, servidores dedicados ou Armazenamento em nuvem fornecer melhor escalabilidade.

Pré-instalação: Preparação do Servidor

Antes de instalar o Magento, seu servidor precisa de configuração adequada. Estas etapas assumem o Ubuntu 22.04, mas os comandos são semelhantes para outras distribuições.

Degrau 1: Atualize seu sistema

Comece com uma nova atualização do sistema:

sudo apt update && sudo apt upgrade -y

Degrau 2: Instale PHP e extensões necessárias

Adicione o repositório PHP e instale o PHP 8.2 com todas as extensões necessárias:

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

Degrau 3: Definir configurações de PHP

Edite seu arquivo de configuração PHP:

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

Encontre e modifique esses valores:

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

Reinicie o PHP-FPM (Gerenciador de processos PHP FastCGI) para aplicar alterações:

sudo systemctl restart php8.2-fpm

Degrau 4: Instale MySQL 8.0

sudo apt install mysql-server -y
sudo mysql_secure_installation

Crie um banco de dados e usuário 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;

Degrau 5: Instale o Nginx

sudo apt install nginx -y
sudo systemctl enable nginx

Degrau 6: Instale o Composer

Composer lida com as dependências do Magento. Instale-o globalmente:

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

Verifique o compositor 2.2+ está instalado. Versões mais antigas causam problemas de dependência.

Degrau 7: Instale o OpenSearch

OpenSearch requer Java. Instale o OpenJDK primeiro:

sudo apt install openjdk-11-jdk -y

Adicione o repositório OpenSearch e instale:

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

Configure o OpenSearch editando /etc/opensearch/opensearch.yml:

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

Inicie e habilite o serviço:

sudo systemctl enable opensearch
sudo systemctl start opensearch

Verifique se está em execução:

curl -X GET "localhost:9200"

Você deverá ver uma resposta JSON com informações do cluster.

Instalando Magento via Composer

O método Composer é a única abordagem de instalação recomendada. Ele lida com as dependências de maneira adequada e simplifica as atualizações. Evite downloads de arquivos ou clones do Git para sites de produção.

Degrau 1: Obtenha chaves de autenticação Magento

Você precisa de chaves de autenticação para baixar o Magento. Crie uma conta gratuita em marketplace.magento.com, então:

1. Go to My Profile > Access Keys
2. Clique “Crie uma nova chave de acesso”
3. Dê um nome (por exemplo, “Instalação do servidor”)
4. Copie a chave pública (nome do usuário) e chave privada (senha)

Armazene essas chaves no arquivo de autenticação global do Composer:

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

Degrau 2: Crie o diretório da web

Crie e navegue até sua raiz da web:

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

Degrau 3: BaixarMagento

Execute o comando create-project do Composer. Para código aberto Magento:

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

Para Adobe Comércio (versão paga):

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

Isso baixa mais de 300 MB de arquivos. Ser paciente.

Degrau 4: Definir permissões de arquivo

Permissões adequadas impedem “Acesso negado” erros e problemas de segurança:

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

Degrau 5: Execute o comando de instalação

Agora execute a instalação real. Personalize esses parâmetros para sua configuração:

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"

A instalação demora 5-15 minutos dependendo da velocidade do servidor. Fique atento a quaisquer erros.

Quando concluído, você verá uma mensagem com seu URL de administrador. É randomizado para segurança (por exemplo, /admin_abc123). Escreva isso.

Degrau 6: Execute comandos pós-instalação

Conclua a configuração com estes comandos essenciais:

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

o static-content:deploy comando gera arquivos CSS e JavaScript. o -f sinalizador força a implantação no modo de desenvolvedor.

Configurando Nginx para Magento

Magento precisa de configuração específica do Nginx. Crie um novo bloco de servidor:

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

Adicione esta configuração (ajustar domínio e caminhos):

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 o site e teste a configuração:

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

Magento fornece um exemplo de configuração Nginx em nginx.conf.sample. A diretiva include acima a utiliza diretamente.

Configurando tarefas Cron

Magento depende muito de cron jobs (Atividades agendadas) para indexação, e-mails, sitemaps, e mais. Sem cron, sua loja não funcionará corretamente.

Execute este comando para gerar as entradas do crontab:

bin/magento cron:install

Isso adiciona três cron jobs. Verifique se eles existem:

crontab -l

Você deverá ver entradas em execução a cada minuto para as tarefas agendadas do Magento.

Otimização de performance: Redis e verniz

Uma loja Magento de produção precisa de cache para um desempenho aceitável. Redis lida com sessões e cache de back-end. Verniz (um acelerador HTTP) lida com cache de página inteira.

Instalando Redis

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

Verifique se o Redis está funcionando:

redis-cli ping

Deveria responder com “PONG”.

Configure o Magento para usar Redis para armazenamento em cache:

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 bancos de dados separados (0, 1, 2) mantém diferentes tipos de cache isolados.

Instalando Verniz

O Varnish fica na frente do seu servidor web e armazena páginas em cache:

sudo apt install varnish -y

Magento gera o arquivo de configuração do Varnish:

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

Você precisará ajustar o Nginx para ouvir na porta 8080 internamente enquanto o Varnish lida com a porta 80. Esta configuração requer configuração adicional além do escopo deste guia, mas a documentação do Magento cobre isso completamente.

Configuração de segurança

Proteger o Magento requer várias etapas. Não pule estes.

Segurança do painel de administração

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

Em segurança, definir essas configurações:

• Compartilhamento de conta de administrador: Definir como “Não” (evita que várias pessoas usem um login)
• Vida útil da senha: Definir como 90 dias
• Máximo de falhas de login: Definir como 5
• Tempo de bloqueio: Definir como 30 minutos

Autenticação de dois fatores

Magento 2.4+ permite autenticação de dois fatores (2FA) por padrão. Isso adiciona uma segunda etapa de verificação além das senhas. Você não pode desativá-lo, então configure-o corretamente:

1. Go to Stores > Configuration > Security > 2FA
2. Ativar o Google Autenticador (ou outro provedor compatível)
3. No primeiro login, digitalize o código QR com seu aplicativo autenticador

Permissões de arquivo

Depois da instalação, restringir permissões:

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 do administrador

Magento gera uma URL de administrador aleatória durante a instalação. Mantenha assim. Não mude para algo previsível como /admin. Se você precisar encontrá-lo mais tarde:

bin/magento info:adminuri

Configuração SSL/HTTPS

Sempre use HTTPS na produção. Depois de instalar um certificado SSL (Vamos criptografar é grátis), 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

Solução de problemas comuns de instalação

Mesmo com configuração cuidadosa, problemas acontecem. Aqui estão os problemas e soluções mais comuns.

Instalação travada em 70%

Isso geralmente significa PHP max_execution_time é muito baixo. Edite php.ini e configure-o para 18000, então reinicie o PHP-FPM. alternativamente, execute a instalação via linha de comando em vez do instalador web.

“A classe não existe” Erros

Esses erros ReflectionException indicam arquivos gerados corrompidos. Limpe-os:

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

Erros de permissão negada

Permissões de arquivo causam cerca de 38% de falhas de instalação. Certifique-se de que o usuário do servidor web (www-dados no Ubuntu) possui todos os arquivos:

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

Extensão PHP ausente

Mensagens de erro como “A extensão PHP solicitada ext-mbstring está faltando” significa que você precisa instalar essa extensão:

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

Falha na conexão do Elasticsearch/OpenSearch

Se o Magento não conseguir se conectar ao seu mecanismo de pesquisa:

1. Verifique se o serviço está em execução: sudo systemctl status opensearch
2. Testar conectividade: curl localhost:9200
3. Verifique se as regras do firewall não estão bloqueando a porta 9200
4. Verifique se o nome do host e a porta em seu comando de instalação correspondem à sua configuração

Memória esgotada

Erros de memória PHP durante a compilação significam que você precisa de mais RAM ou espaço de troca:

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

Páginas em branco ou 500 Erros

Ative o modo de desenvolvedor para ver os erros reais:

bin/magento deploy:mode:set developer

Verifique os arquivos de log em var/log/exception.log e var/log/system.log para detalhes.

Lista de verificação pós-instalação

Após instalação bem-sucedida, conclua estas etapas:

• Faça login no painel de administração e defina as configurações da loja (nome, fuso horário, moeda)
• Configurar métodos de envio
• Configurar gateways de pagamento
• Crie grupos de clientes e regras fiscais
• Configure modelos de e-mail e SMTP
• Configurar robots.txt e mapas de sites
• Instale extensões essenciais via Composer
• Configure backups automatizados
• Mudar para modo de produção: bin/magento deploy:mode:set production

perguntas frequentes

Posso instalar o Magento em hospedagem compartilhada??

Tecnicamente sim, mas não é recomendado. Magento requer configurações específicas de PHP, Acesso SSH, e compositor. A maioria dos hosts compartilhados não fornece estes. Você também atingirá os limites de memória rapidamente. Hospedagem VPS é a opção prática mínima.

Quanto tempo leva a instalação do Magento?

A preparação do servidor leva 30-60 minutos se você estiver familiarizado com Linux. A instalação real do Magento leva 10-20 minutos. Usuários iniciantes devem fazer um orçamento 2-4 horas para o processo completo, incluindo solução de problemas.

Preciso do Elasticsearch ou OpenSearch?

sim, um deles é obrigatório para Magento 2.4+. MySQL não lida mais com pesquisas de catálogo. OpenSearch é a escolha recomendada para novas instalações, pois é totalmente de código aberto e mantido ativamente.

Qual é a diferença entre Magento Open Source e Adobe Commerce?

Magento Open Source é gratuito e apoiado pela comunidade. Adobe Commerce (anteriormente Magento Commerce) é a versão paga com recursos adicionais, como funcionalidade B2B, ferramentas avançadas de marketing, e opções de hospedagem em nuvem. Adobe Commerce começa em US$ 22.000/ano. Ambos compartilham o mesmo processo de instalação.

Posso migrar do WooCommerce para Magento??

sim, mas requer um planejamento cuidadoso. Você precisará exportar produtos, clientes, e pedidos do WooCommerce e importá-los para o Magento. Existem várias extensões de migração, embora lojas complexas possam precisar de desenvolvimento personalizado. Considere contratar um especialista em Magento para grandes catálogos.

Como faço para atualizar o Magento após a instalação?

Use o Composer para atualizar: composer update magento/product-community-edition --with-all-dependencies. Sempre faça backup de seu banco de dados e arquivos primeiro. Testar atualizações em um ambiente de teste antes da produção. Correr bin/magento setup:upgrade depois de atualizar.

Por que minha loja Magento está lenta?

Magento sem cache é lento por design. Ele gera páginas dinamicamente. Habilite Redis para cache de back-end e Varnish para cache de página inteira. Ativar modo de produção, que pré-compila o código. Use um CDN para ativos estáticos. Considere atualizar seu recursos do servidor se o tráfego estiver alto.