Pular para o conteúdo
Documentação

Passo a passo: hospedar uma loja Magento 2

Roteiro completo para publicar uma loja Magento 2: conta, banco, domínio com template Magento e document root pub, permissões e cron.

R Regis Manze 20/11/2026 4 min de leitura

Este roteiro serve para publicar uma loja Magento 2 do zero no miniCP. Nos exemplos, a conta é cliente, o domínio é exemplo.com.br e o PHP é 8.3. Troque pelos seus valores.

Atenção: o Magento 2.4 também precisa de um servidor OpenSearch (busca), que não é criado por estas telas. Tenha um disponível antes de instalar a loja.

1. Criar a conta

  1. Acesse Hospedagem > Usuários e clique em Novo Usuario.
  2. Nome de Usuario: cliente.
  3. Shell: Bash (o Magento usa linha de comando).
  4. Cota de Disco (MB): deixe folga. Lojas Magento crescem rápido com mídia e cache.
  5. Clique em Criar.

2. Criar o banco

  1. Acesse Hospedagem > Bancos de Dados e, no bloco Local, clique em Novo banco.
  2. Nome do banco: cliente_magento.
  3. Dono (conta): cliente.
  4. Acesso: Criar usuario novo. Usuario: cliente_magento. Senha: vazio, para gerar uma forte.
  5. Host de acesso: localhost.
  6. Clique em Criar e anote a senha exibida na mensagem.

3. Criar o domínio

  1. Acesse Hospedagem > Dominios e clique em Novo Dominio.
  2. Preencha:
Campo Valor
Dominio exemplo.com.br
Aliases www.exemplo.com.br
Tipo de aplicacao PHP
Usuario cliente
PHP Versão suportada pela sua versão do Magento (ex.: 8.3)
Document Root public_html/pub
Template da Aplicacao Magento 2
Arquivos iniciais Desmarque os dois
  1. Se as integrações estiverem ligadas, marque Provisionar no HAProxy (com Incluir www.dominio) e Criar registro DNS na Cloudflare.
  2. Clique em Criar.

O document root fica na pasta pub porque é ela que o Magento publica. O código da loja fica em public_html, fora do alcance direto do navegador. O template Magento 2 aplica as regras de rewrite no modo NGINX Only e ajusta o PHP-FPM da conta para o Magento.

4. Enviar e instalar a loja

O código vai em /home/cliente/public_html (a pasta acima de pub). Escolha um caminho:

  • Terminal: em Usuários, clique em Acessar como na conta cliente e abra Terminal.
  • FTP: crie uma conta FTP vinculada a cliente, com diretório /home/cliente/public_html.
  • Deploy: se o código está num repositório Git, clone-o na pasta e use o Deploy depois.

Na instalação, use os dados do banco do passo 2:

cd ~/public_html
php8.3 bin/magento setup:install \
  --base-url=https://exemplo.com.br/ \
  --db-host=localhost \
  --db-name=cliente_magento \
  --db-user=cliente_magento \
  --db-password='SENHA-ANOTADA' \
  ...demais opções da sua loja

5. Corrigir permissões

  1. Em Usuários, clique em Aplicar permissoes nas pastas na conta cliente.
  2. Escopo: Sites.
  3. Deixe marcados Remover +x de arquivos comuns e Proteger arquivos sensiveis com 640. O bin/magento continua executável.
  4. Clique em Aplicar e aguarde. Em lojas grandes leva alguns minutos.

6. Agendar o cron

  1. Em Usuários, clique em Acessar como na conta cliente.
  2. Abra Cron Jobs e clique em Novo Cron Job.
  3. Em Atalhos, clique em A cada min.
  4. Em Comando, informe:
/usr/bin/php8.3 /home/cliente/public_html/bin/magento cron:run
  1. Clique em Adicionar.
  2. Clique em Voltar ao Admin.

Atenção: use no cron a mesma versão do PHP do domínio. Se trocar a versão do site depois, atualize o comando.

7. Conferir

  • Abra a loja e o painel administrativo do Magento.
  • Erros do servidor web: /home/cliente/logs/.
  • Erros do Magento: /home/cliente/public_html/var/log/.

Várias lojas (multi-loja) no mesmo código

Para atender várias lojas (websites ou store views) com uma única instalação, o Magento lê MAGE_RUN_CODE e MAGE_RUN_TYPE do ambiente. No miniCP, isso se faz com as variáveis de ambiente por domínio:

  1. Crie cada loja como um domínio próprio (não como alias), na mesma conta e com o mesmo Document Root public_html/pub. Aliases compartilham o vhost e, por isso, as mesmas variáveis.
  2. Em Dominios, clique no ícone { } na linha de cada domínio e informe as variáveis da loja:
Domínio Variáveis
loja1.exemplo.com.br MAGE_RUN_CODE=base e MAGE_RUN_TYPE=website
loja2.exemplo.com.br MAGE_RUN_CODE=loja2 e MAGE_RUN_TYPE=website
  1. Clique em Salvar e recarregar em cada um.

Use MAGE_RUN_TYPE=website quando o código for de um website, ou store quando for de uma store view. O código precisa existir no Magento (Stores > All Stores). Configure também a Base URL de cada website no Magento.

Dica: as variáveis também podem ser definidas pela API, com o campo env do PATCH /api/v1/domains/<dominio>. Veja Gerenciar domínios e API: criar, editar e remover domínios.

Atualizações futuras

Em Dominios, clique em Deploy (git pull + build) e escolha o modelo Magento. Como o document root é pub, comece o pipeline com cd .. para rodar os comandos na raiz da loja.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!