Como agendar tarefas recorrentes com crontab direto pelo terminal SSH

Como agendar tarefas recorrentes com crontab direto pelo terminal SSH

Olá, amigo(a) desenvolvedor(a) ou administrador(a) de site! Seja bem-vindo(a) ao nosso Guia da Sensei da GeHost — onde aprendemos juntos, com paciência e carinho, a dominar o poder do servidor com segurança e elegância. Hoje vamos aprender algo incrível: agendar tarefas recorrentes usando o crontab diretamente pelo terminal SSH.

Imagine que você quer que seu site faça uma limpeza automática de arquivos temporários toda segunda-feira às 3 da manhã, ou envie um relatório diário de visitas. Com o crontab, isso é possível — e sem precisar de plugins ou ferramentas externas. Vamos lá?

Antes de começar: o que você precisa

• Seu acesso SSH (já ativado em seu plano de hospedagem).
• Conhecimento básico de comandos no terminal (como cd, ls, nano).
• Um plano de hospedagem que permita acesso SSH (todos os planos da GeHost permitem, desde que ativado no painel).

Dica da Sensei: Se você ainda não ativou o SSH, acesse seu painel no painel.gehost.com.br > "SSH & Shell" > "Ativar SSH". É rápido e seguro!

Passo a passo: configurando o crontab pelo terminal

1. Conecte-se ao servidor via SSH
   Abra seu terminal (ou o cliente SSH como PuTTY, Termius, etc.) e digite:

   ssh seu_usuario@seu_dominio.com.br

   Substitua seu_usuario e seu_dominio.com.br pelos dados do seu acesso. Se não souber, verifique no painel do cliente.
2. Abra o editor de tarefas crontab
   Digite o comando:

   crontab -e

   O sistema vai abrir o editor de texto (geralmente nano). Se for a primeira vez, ele pode pedir para escolher um editor — escolha nano (é mais fácil para iniciantes).
3. Escreva sua tarefa recorrente
   No editor, digite uma linha no formato padrão do crontab:

   # Minuto Hora DiaDoMês Mês DiaDaSemana Comando

   Exemplo: Executar um script de backup às 2 da manhã todos os dias:

   0 2 * * * /home/seu_usuario/public_html/backup.sh

   • 0 → minuto (0)
   • 2 → hora (2 da manhã)
   • * → todo dia do mês
   • * → todo mês
   • * → todos os dias da semana
   • /home/seu_usuario/public_html/backup.sh → caminho do script a ser executado
   Importante: O caminho deve ser absoluto. Use pwd no terminal para verificar o caminho atual.
4. Salve e feche o arquivo
   No nano, pressione Ctrl + O para salvar, depois Enter para confirmar. Depois, pressione Ctrl + X para sair.
5. Verifique se a tarefa foi salva
   Digite:

   crontab -l

   Isso lista todas as tarefas agendadas. Confira se sua linha apareceu corretamente.
6. Teste o script manualmente
   Antes de confiar na automação, execute o script diretamente:

   ./backup.sh

   Ou:

   bash /home/seu_usuario/public_html/backup.sh

   Certifique-se de que ele funciona sem erros.
7. Pronto! A tarefa está agendada
   A partir de agora, o sistema executará seu comando automaticamente, conforme o horário definido. Você pode verificar logs de execução no log do servidor (via painel ou por e-mail, se configurado).

Dicas da Sensei para não errar

• Use sempre caminhos absolutos — evite caminhos relativos como ./script.sh. Use /home/seu_usuario/public_html/script.sh.
• Teste seu script antes — se ele falhar, a tarefa recorrente também falhará.
• Evite tarefas muito pesadas — agendamentos muito frequentes podem sobrecarregar o servidor. Espere 15 minutos entre tarefas pesadas.
• Use comentários — comece linhas com # para explicar o que a tarefa faz. Isso ajuda você mesmo daqui a 6 meses!

Curiosidade da Sensei: O nome crontab vem de chronos, que significa "tempo" em grego. É como se o sistema fosse um relógio de sabedoria, sempre marcando o momento certo para agir.

Quer saber mais?

Se precisar de ajuda com scripts, testes ou logs, o suporte da GeHost está sempre disponível — e está incluso no seu plano. Acesse o painel do cliente e abra um chamado. Estamos aqui para te ajudar com um sorriso no coração.

Se você gostou deste guia, compartilhe com um colega. Juntos, vamos tornar o mundo da web um lugar mais inteligente, organizado e humano.

Com carinho,
Sensei da GeHost
*G e Soluções e Eventos LTDA – CNPJ: 46.647.904/0001-04*