O que é o crontab (e por que ele vai facilitar sua vida)
Imagina ter um funcionário invisível, que nunca dorme, nunca esquece e faz exatamente a tarefa que você pediu, sempre no horário certo. É basicamente isso que o crontab faz pelo seu site ou servidor. Ele é o "agendador de tarefas" do Linux — o sistema que roda por trás da sua hospedagem — e permite programar comandos para rodarem sozinhos, automaticamente, em datas e horários que você define.
Serve, por exemplo, para rodar rotinas de backup, disparar scripts de manutenção, limpar arquivos temporários ou executar qualquer tarefa do seu site sem que você precise ficar lembrando de fazer isso manualmente. Bora aprender a mexer nele com calma, passo a passo? 🙂
Passo 1: Acessando o terminal via SSH
Antes de tudo, você precisa entrar no seu ambiente de hospedagem através do terminal (SSH), e não pelo navegador. Para isso:
- Confirme no painel.gehost.com.br se o seu plano possui acesso SSH liberado — nem todo plano vem com isso habilitado por padrão, então vale conferir por lá ou pedir confirmação ao suporte.
- Use um programa de terminal (no Windows, algo como PowerShell ou PuTTY; no Mac/Linux, o próprio Terminal já serve).
- Conecte usando o comando abaixo, trocando pelos dados reais da sua conta (usuário e endereço você encontra no painel):
ssh seu_usuario@seudominio.com.br
💡 Dica da Sensei: guarde seu usuário e senha de SSH com carinho, como se fossem a chave de casa. Se você não tem certeza de qual é o seu usuário ou se o acesso está ativo, é só chamar o suporte — eles te ajudam a liberar certinho.
Passo 2: Abrindo sua tabela de tarefas com "crontab -e"
Depois de conectado, você vai abrir o editor de agendamentos. É só digitar o comando:
crontab -e
Na primeira vez, o sistema pode perguntar qual editor de texto você quer usar. Se aparecer uma lista numerada, escolha a opção do nano (geralmente é a mais simples para quem está começando). Pronto, você está dentro da sua tabela de tarefas — mesmo que ela ainda esteja vazia, é normal!
Passo 3: Entendendo a sintaxe (os 5 campos mágicos)
Toda linha de agendamento no crontab segue sempre a mesma receita: cinco campos de tempo, seguidos do comando que você quer executar. É mais simples do que parece:
- Minuto (0 a 59)
- Hora (0 a 23)
- Dia do mês (1 a 31)
- Mês (1 a 12)
- Dia da semana (0 a 6, sendo 0 = domingo)
Depois desses cinco campos, vem o comando que deve ser executado. Um asterisco (*) em qualquer campo significa "todo/qualquer valor" — é o coringa do crontab.
Passo 4: Exemplos práticos para você adaptar
Veja alguns modelos de linha e o que cada um faz. Você pode copiar e ajustar o comando final conforme a sua necessidade:
- 0 3 * * * /caminho/do/seu/script.sh — roda todo dia, às 3h da manhã.
- */30 * * * * /caminho/do/seu/script.sh — roda a cada 30 minutos, o tempo todo.
- 0 0 1 * * /caminho/do/seu/script.sh — roda uma vez por mês, sempre no dia 1º, à meia-noite.
- 0 9 * * 1 /caminho/do/seu/script.sh — roda toda segunda-feira, às 9h da manhã.
💡 Dica da Sensei: sempre use o caminho completo do script ou comando (por exemplo, /home/seuusuario/scripts/backup.sh), em vez de só o nome do arquivo. O crontab não conhece os "atalhos" que você usa no dia a dia — ele precisa do endereço completinho para não se perder.
Passo 5: Salvando sua tarefa agendada
Depois de digitar sua linha de agendamento no editor nano:
- Pressione Ctrl + O para gravar (o "O" de "output") e depois Enter para confirmar o nome do arquivo.
- Pressione Ctrl + X para sair do editor.
- Para conferir se sua tarefa foi salva corretamente, digite crontab -l — isso lista todas as tarefas agendadas na sua conta.
Editando ou removendo uma tarefa
Para editar, é só rodar crontab -e de novo, apagar ou ajustar a linha desejada e salvar do mesmo jeito. Se quiser remover todas as tarefas agendadas de uma vez (use com bastante cuidado!), o comando é crontab -r.
⚠️ Atenção: o comando crontab -r apaga tudo sem pedir confirmação. Se você tem várias tarefas agendadas, o caminho mais seguro é entrar em crontab -e e apagar só a linha específica que não quer mais.
Erros comuns que a Sensei já viu por aí
- Esquecer de dar permissão de execução ao script (o comando chmod +x seuscript.sh resolve isso).
- Usar caminhos relativos em vez do caminho completo do arquivo.
- Confundir os campos de horário — lembre-se: minuto vem antes da hora, não o contrário.
- Agendar uma tarefa pesada para rodar a cada minuto sem necessidade, sobrecarregando o servidor à toa.
Prefere não usar o terminal?
Se você se sentir mais confortável com uma interface visual, o cPanel também conta com uma seção própria de Cron Jobs, onde dá para agendar tarefas preenchendo campos, sem precisar digitar comandos. As duas formas funcionam sobre a mesma base do sistema — a diferença é só o "jeitinho" de configurar.
Ficou com alguma dúvida?
Automação é ótima, mas sabemos que o terminal pode assustar um pouco no começo — e tudo bem! Se travar em qualquer passo, ou não tiver certeza se seu plano possui acesso SSH liberado, é só chamar o suporte da GeHost. A gente te ajuda a deixar tudo rodando certinho. 🌱
