Como configurar cron jobs diretamente pelo terminal usando crontab

Cron Jobs via Terminal: o jeito raiz de automatizar tarefas na sua hospedagem

Oi! Aqui é a Sensei da GeHost 🥋 Se você já mexeu em cron jobs pelo cPanel visual e quer um passo além — controlar tudo direto pelo terminal, editando o crontab na mão — esse guia é pra você. Vou te mostrar com calma, sem enrolação técnica, prometo.

Antes de começar: acesso via terminal/SSH é um recurso mais avançado e pode depender do seu plano ou precisar ser liberado. Se você tentar acessar e não conseguir, fala com o nosso suporte pelo painel.gehost.com.br que a gente confirma a disponibilidade pra sua conta.

O que é um cron job, afinal?

Cron job é uma tarefa que o servidor executa sozinho, em horários programados — sem você precisar clicar em nada. Pode ser rodar um script PHP, disparar um backup, limpar arquivos temporários, enviar um e-mail automático… o que você programar, o cron cumpre.

Passo 1 — Acesse o terminal da sua hospedagem

Existem duas formas principais de chegar num terminal na GeHost:

• Pelo cPanel: faça login no seu cPanel e procure a ferramenta "Terminal" (geralmente na seção de Avançado). Ela abre uma linha de comando direto no navegador, sem precisar instalar nada.
• Via SSH: se você usa um cliente SSH (Terminal do Mac/Linux, PuTTY no Windows etc.), conecte usando o usuário e a senha (ou chave) da sua conta de hospedagem — os dados de acesso ficam disponíveis no seu painel.

Passo 2 — Abra o editor de crontab

Com o terminal aberto, digite o comando abaixo e aperte Enter:

crontab -e

Na primeira vez, o sistema pode perguntar qual editor de texto você quer usar. Se aparecer uma lista, escolha a opção mais simples (geralmente nano — é o mais amigável pra quem não é íntimo de terminal).

Passo 3 — Entenda a estrutura de uma linha de cron

Cada linha do crontab segue este formato, com 5 campos de tempo + o comando:

* * * * * comando-a-ser-executado
| | | | |
| | | | +---- dia da semana (0-6, domingo=0)
| | | +------ mês (1-12)
| | +-------- dia do mês (1-31)
| +---------- hora (0-23)
+------------ minuto (0-59)

Alguns exemplos práticos:

• 0 3 * * * /usr/bin/php /home/seuusuario/public_html/script.php — roda todo dia às 3h da manhã.
• */15 * * * * /usr/bin/php /home/seuusuario/public_html/checar.php — roda a cada 15 minutos.
• 0 0 1 * * /usr/bin/php /home/seuusuario/public_html/mensal.php — roda todo dia 1º do mês, à meia-noite.

Passo 4 — Salve e confira

1. Depois de escrever sua linha, salve o arquivo (no nano: Ctrl+O, Enter, depois Ctrl+X pra sair).
2. Pra conferir se salvou certinho, digite:

   crontab -l

   Isso lista todos os cron jobs ativos na sua conta.

Dica de sensei: se você prefere uma tela visual em vez de editar na mão, o cPanel também tem a ferramenta gráfica de "Cron Jobs" — o resultado final é o mesmo, é só uma questão de gosto (ou de coragem 😄).

Erros comuns (e como evitar)

• Caminho incompleto: sempre use o caminho completo do arquivo (ex.: /home/seuusuario/public_html/script.php) e do executável (ex.: /usr/bin/php). O cron não conhece atalhos que funcionam no seu computador.
• Testar o script antes: rode o comando manualmente no terminal primeiro, pra garantir que ele funciona sem erro, antes de agendar.
• Silenciar o e-mail de saída: por padrão, o cron pode te mandar um e-mail toda vez que o script rodar. Se isso for incomodar, adicione > /dev/null 2>&1 no final da linha.
• Cuidado ao apagar linhas: ao editar o crontab -e, apague só a linha que quer remover — apagar tudo sem querer some com todos os agendamentos.

Precisa de ajuda?

Se travar em algum passo ou não tiver certeza se seu script está pronto pra rodar via cron, é só chamar o suporte da GeHost pelo painel.gehost.com.br. A gente te ajuda com todo carinho — automação é ótima, mas não precisa enfrentar sozinho! 💙