Pular para o conteúdo
Documentação

Passo a passo: hospedar um site Laravel

Roteiro para publicar uma aplicação Laravel: conta, banco, domínio com template Laravel e document root public, .env, deploy e agendador.

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

Este roteiro serve para publicar uma aplicação Laravel no miniCP a partir de um repositório Git. Nos exemplos, a conta é cliente, o domínio é exemplo.com.br e o PHP é 8.3.

1. Criar a conta e o banco

  1. Em Hospedagem > Usuários, clique em Novo Usuario, crie a conta cliente com Shell Bash e clique em Criar.
  2. Em Hospedagem > Bancos de Dados, clique em Novo banco no bloco Local.
  3. Nome do banco: cliente_app. Dono (conta): cliente.
  4. Acesso: Criar usuario novo, Host de acesso localhost, senha vazia para gerar.
  5. Clique em Criar e anote a senha.

2. Criar o domínio

  1. Em Hospedagem > Dominios, clique em Novo Dominio.
  2. Preencha:
Campo Valor
Dominio exemplo.com.br
Aliases www.exemplo.com.br
Tipo de aplicacao PHP
Usuario cliente
PHP 8.3 (ou a versão exigida pelo projeto)
Document Root public_html/public
Template da Aplicacao Laravel
Arquivos iniciais Desmarque os dois
  1. Clique em Criar.

O Laravel publica só a pasta public. O restante do projeto, incluindo o .env, fica em public_html, fora do alcance do navegador.

3. Clonar o projeto

  1. Em Usuários, clique em Acessar como na conta cliente e abra Terminal.
  2. Clone o repositório dentro de public_html. Como o painel já criou a pasta public, clone num diretório temporário e mova:
cd ~
git clone git@github.com:empresa/app.git app-tmp
rm -rf public_html && mv app-tmp public_html
cd public_html
cp .env.example .env
  1. Edite o .env com os dados do banco:
APP_URL=https://exemplo.com.br
DB_CONNECTION=mysql
DB_HOST=localhost
DB_DATABASE=cliente_app
DB_USERNAME=cliente_app
DB_PASSWORD=SENHA-ANOTADA
  1. Gere a chave:
php8.3 $(command -v composer) install --no-dev --optimize-autoloader
php8.3 artisan key:generate

Dica: para o git clone funcionar, cadastre uma chave SSH de deploy da conta (~/.ssh) no repositório.

4. Primeiro deploy

  1. Volte ao admin com Voltar ao Admin.
  2. Em Dominios, clique em Deploy (git pull + build) na linha do site.
  3. Clique no modelo Laravel.
  4. Como o document root é public, acrescente cd .. na primeira linha:
cd ..
git pull
php8.3 $(command -v composer) install --no-dev --optimize-autoloader
php8.3 artisan migrate --force
php8.3 artisan config:cache
php8.3 artisan route:cache
php8.3 artisan view:cache
  1. Clique em Executar Deploy. O pipeline fica salvo para as próximas vezes.

5. Permissões

Em Usuários, clique em Aplicar permissoes nas pastas, escolha Sites e clique em Aplicar. O .env fica com 640 e o artisan continua executável.

6. Agendador do Laravel

  1. Acessar como a conta cliente e abra Cron Jobs.
  2. Clique em Novo Cron Job e em A cada min.
  3. Comando:
cd /home/cliente/public_html && /usr/bin/php8.3 artisan schedule:run
  1. Clique em Adicionar.

7. Filas (opcional)

Se a aplicação usa filas, crie o worker em Servicos, no painel do cliente, com o comando php8.3 artisan queue:work.

Logs do servidor web: /home/cliente/logs/. Logs do Laravel: /home/cliente/public_html/storage/logs/.

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!