O Terminal abre uma linha de comando no navegador, com o seu usuário, sem precisar de programa de SSH. Use para rodar comandos do Laravel (php artisan), do Magento (php bin/magento), Git e utilitários do sistema.
Abrir o terminal
- No menu lateral, clique em Terminal.
- A janela abre em tela cheia, com o título Terminal - usuario@servidor.
- Aguarde a etiqueta no canto superior direito mudar para Conectado.
- Digite os comandos normalmente.
| Etiqueta | Significado |
|---|---|
| Conectando... | O terminal está abrindo a sessão |
| Conectado | Pronto para usar |
| Desconectado | A sessão foi encerrada |
| Erro de conexao | Não foi possível abrir a sessão. Recarregue a página e tente de novo |
Para fechar, clique no X no canto superior direito. Fechar a janela encerra a sessão e qualquer comando que esteja rodando nela.
Regras do terminal
- Os comandos rodam com o seu usuário, com as mesmas permissões dos seus arquivos.
- O terminal começa na sua pasta pessoal (
/home/usuario) e fica preso a ela: se tentar sair comcd, você volta para a pasta pessoal e vê a mensagem "Acesso restrito a /home/usuario". - Só existe uma sessão por conta. Abrir o terminal em outra aba ou outro computador encerra a sessão anterior.
- Contas suspensas não conseguem abrir o terminal, e uma sessão aberta é fechada automaticamente quando a conta é suspensa.
- Não há acesso de administrador (
sudo). Instalação de pacotes do sistema e mudanças no servidor são com o administrador.
Atenção: comandos longos, como uma importação grande, param se você fechar a janela ou a conexão cair. Para tarefas demoradas, prefira um Servico ou peça ajuda ao administrador.
Comandos úteis
Use o PHP da mesma versão do seu domínio (veja em Meus Dominios). Exemplos com PHP 8.3:
Laravel
cd ~/public_html
php8.3 artisan migrate --force
php8.3 artisan optimize
php8.3 artisan queue:restart
Magento 2
cd ~/public_html
php8.3 bin/magento setup:upgrade
php8.3 bin/magento setup:di:compile
php8.3 bin/magento setup:static-content:deploy pt_BR en_US -f
php8.3 bin/magento cache:flush
Git
cd ~/public_html
git status
git pull
git log --oneline -5
Espaço em disco e arquivos
du -sh ~/* | sort -h # o que ocupa mais espaço
tail -f ~/logs/exemplo.com.br-error.log # acompanhar erros
Os logs em ~/logs podem ser lidos, mas não apagados nem esvaziados pelo terminal. Para limpá-los, use Limpar Logs Antigos em Meus Logs.
Dicas de uso
- Use Tab para completar nomes de arquivos e pastas.
- Use as setas para cima e para baixo para repetir comandos anteriores.
- Ctrl+C interrompe o comando em execução.
- Para copiar, selecione o texto com o mouse; para colar, use Ctrl+Shift+V ou o botão direito, conforme o navegador.
Dica: depois de alterar código pelo terminal, faça o Reload do PHP-FPM em Meus Dominios e reinicie os serviços de fila em Servicos.
Problemas comuns
| Sintoma | O que fazer |
|---|---|
| Fica em Conectando... | Recarregue a página do painel e abra o terminal de novo |
| Sessão cai sozinha | Verifique se não abriu o terminal em outra aba ou com o mesmo usuário em outro lugar, ou se a conta foi suspensa |
Permission denied |
O arquivo não pertence à sua conta ou não tem permissão. Ajuste em Meus Arquivos > Permissoes. Nos logs de ~/logs isso é esperado: eles são somente leitura |
command not found |
O programa não está instalado no servidor. Peça ao administrador |