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
- Acesse Hospedagem > Usuários e clique em Novo Usuario.
- Nome de Usuario:
cliente. - Shell: Bash (o Magento usa linha de comando).
- Cota de Disco (MB): deixe folga. Lojas Magento crescem rápido com mídia e cache.
- Clique em Criar.
2. Criar o banco
- Acesse Hospedagem > Bancos de Dados e, no bloco Local, clique em Novo banco.
- Nome do banco:
cliente_magento. - Dono (conta):
cliente. - Acesso: Criar usuario novo. Usuario:
cliente_magento. Senha: vazio, para gerar uma forte. - Host de acesso: localhost.
- Clique em Criar e anote a senha exibida na mensagem.
3. Criar o domínio
- Acesse Hospedagem > Dominios e clique em Novo Dominio.
- 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 |
- Se as integrações estiverem ligadas, marque Provisionar no HAProxy (com Incluir www.dominio) e Criar registro DNS na Cloudflare.
- 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
clientee 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
- Em Usuários, clique em Aplicar permissoes nas pastas na conta
cliente. - Escopo: Sites.
- Deixe marcados Remover +x de arquivos comuns e Proteger arquivos sensiveis com 640. O
bin/magentocontinua executável. - Clique em Aplicar e aguarde. Em lojas grandes leva alguns minutos.
6. Agendar o cron
- Em Usuários, clique em Acessar como na conta
cliente. - Abra Cron Jobs e clique em Novo Cron Job.
- Em Atalhos, clique em A cada min.
- Em Comando, informe:
/usr/bin/php8.3 /home/cliente/public_html/bin/magento cron:run
- Clique em Adicionar.
- 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:
- 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. - 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 |
- 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
envdoPATCH /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.