Pular para o conteúdo
Documentação

Passo a passo: publicar um site Laravel

Guia completo para colocar uma aplicação Laravel no ar no miniCP: código, .env, banco, cron do scheduler e worker de fila.

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

Este guia mostra como colocar uma aplicação Laravel no ar usando o painel do cliente: enviar o código, configurar o .env, rodar as migrações, agendar o scheduler e manter o worker de fila rodando.

Nos exemplos, o usuário é cliente, o domínio é exemplo.com.br e o PHP é 8.3. Troque pelos seus dados.

Antes de começar: peça ao administrador

Alguns itens só o administrador configura. Peça ao seu provedor:

  1. O domínio exemplo.com.br criado na sua conta, com a versão do PHP exigida pelo projeto.
  2. A pasta pública (document root) apontando para public_html/public. O Laravel só deve expor a pasta public.
  3. Um banco de dados, com nome, usuário e senha.
  4. O certificado SSL do domínio.

Confira em Meus Dominios se a coluna Document Root termina em /public_html/public.

Atenção: se o document root apontar para public_html, o .env e o código-fonte ficam acessíveis pela internet. Não publique o site antes de corrigir.

1. Enviar o código

Opção A: Git Clone

  1. Abra Meus Arquivos e entre em public_html. Ela precisa estar vazia: exclua o index.html de exemplo, se houver.
  2. Clique em Git Clone.
  3. Em URL do Repositorio, informe o endereço do projeto.
  4. Em Diretorio destino, digite public_html.
  5. Em Branch, informe a branch de produção (ex.: main).
  6. Clique em Clonar e aguarde "Repositorio clonado com sucesso".

Opção B: Upload de .zip

  1. Compacte o projeto em um .zip (sem a pasta node_modules).
  2. Em Meus Arquivos, entre em public_html e clique em Upload.
  3. Selecione o .zip, marque Descompactar apos upload e clique em Enviar.
  4. Confira se o arquivo artisan ficou direto em public_html, e não em uma subpasta.

2. Instalar dependências

Abra o Terminal e rode:

cd ~/public_html
composer install --no-dev --optimize-autoloader

Se o comando composer não existir no servidor, peça ao administrador ou envie a pasta vendor junto com o código.

3. Configurar o .env

  1. Abra Associacoes. No quadro Arquivo .env da aplicação, confira em Arquivo se o caminho termina em public_html/.env. Com o campo Pasta do projeto (onde a aplicacao le o .env) vazio, o painel detecta o Laravel sozinho e mostra a sugestão "automatico: public_html" (desde que ainda não exista um ~/.env). Se o caminho for outro, digite public_html no campo e clique em Usar esta pasta.

  2. Clique em Banco de Dados. Preencha com os dados do administrador e clique em Adicionar.

  3. Clique em Testar Conexao para conferir se o banco responde.

  4. Se usar Redis, cadastre também em Redis.

  5. No quadro Arquivo .env da aplicação, clique em Gerar das Associacoes.

  6. Complete o restante das variáveis do projeto, por exemplo:

    APP_NAME=Exemplo
    APP_ENV=production
    APP_DEBUG=false
    APP_URL=https://exemplo.com.br
    QUEUE_CONNECTION=database
    
  7. Clique em Salvar.

  8. No Terminal, gere a chave da aplicação:

    cd ~/public_html
    php8.3 artisan key:generate --force
    

Atenção: mantenha APP_DEBUG=false em produção. Com true, erros mostram senhas e caminhos para qualquer visitante.

4. Preparar a aplicação

No Terminal:

cd ~/public_html
php8.3 artisan migrate --force
php8.3 artisan storage:link
php8.3 artisan optimize

Se o projeto usa front-end compilado (Vite), envie a pasta public/build já gerada no seu computador ou no pipeline.

5. Agendar o scheduler (cron)

  1. Abra Cron Jobs e clique em Novo Cron Job.

  2. Clique no atalho A cada min.

  3. Em Comando:

    /usr/bin/php8.3 /home/cliente/public_html/artisan schedule:run >> /dev/null 2>&1
    
  4. Clique em Adicionar.

6. Criar o worker de fila

Se o projeto usa filas (QUEUE_CONNECTION diferente de sync):

  1. Abra Servicos e clique em Laravel Queue em Templates Rapidos.
  2. Confira a Versao PHP e o Comando. Ajuste --queue= se usar outras filas.
  3. Clique em Criar e Iniciar e confira se o status ficou Ativo.

Se usar Horizon, crie o serviço com o modelo Laravel Horizon no lugar do Laravel Queue.

7. Recarregar o PHP e testar

  1. Em Meus Dominios, clique em Reload no quadro PHP-FPM.
  2. Abra https://exemplo.com.br no navegador.
  3. Se aparecer erro, consulte Meus Logs (tipo Error) e o arquivo storage/logs/laravel.log em Meus Arquivos.

Atualizações seguintes (deploy)

A cada nova versão:

  1. Meus Arquivos > Git Pull na pasta public_html (ou novo upload).

  2. No Terminal:

    cd ~/public_html
    composer install --no-dev --optimize-autoloader
    php8.3 artisan migrate --force
    php8.3 artisan optimize
    
  3. Servicos > Reiniciar no worker de fila.

  4. Meus Dominios > Reload do PHP-FPM.

Dica: se a página mostrar erro 500 logo após o deploy, rode php8.3 artisan optimize:clear e confira as permissões das pastas storage e bootstrap/cache.

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!