Ubuntu cron

O cron executa comandos sozinho, em horários marcados: "todo dia às 2h, faça backup", "a cada 5 minutos, confira o disco". O nome vem do grego chronos, "tempo". Você escreve a agenda num arquivo chamado crontab (cron table, "tabela do cron").

Antes, leia Primeiro Script. Os exemplos rodam na máquina fictícia notebook, com a usuária ana.

Como o cron funciona

O cron é um serviço: um programa que fica rodando em segundo plano desde que o computador liga. A cada minuto, ele acorda, olha as agendas de todos os usuários e executa o que estiver marcado para aquele minuto. No Ubuntu ele já vem instalado e ligado:

$ systemctl is-active cron
active

Cada usuário tem a sua agenda. As tarefas da ana rodam como a ana, com as permissões dela. Tarefas do sistema ficam em arquivos separados, que você verá mais abaixo.

Ver e editar a sua agenda

crontab -l: listar

O -l (de list) mostra a sua agenda. Na primeira vez, ela não existe:

$ crontab -l
no crontab for ana

crontab -e: editar

O -e (de edit) abre a agenda num editor de texto. Na primeira vez, o Ubuntu pergunta qual editor usar:

$ crontab -e
no crontab for ana - using an empty one
Select an editor.  To change later, run select-editor again.
  1. /bin/nano        <---- easiest
  2. /usr/bin/vim.tiny
  3. /bin/ed

Choose 1-3 [1]: 1                                   « Enter ou 1 escolhe o nano

Escolha o nano, o mais fácil (veja nano e vim). O arquivo abre com um texto explicativo, todo em linhas que começam com # (comentários). Vá até o fim, escreva sua tarefa, salve com Ctrl+O, Enter e saia com Ctrl+X. Se estiver tudo certo, o cron confirma:

$ crontab -e
crontab: installing new crontab                     « a agenda foi gravada
$ crontab -l
# m h  dom mon dow   command
30 2 * * * /home/ana/bin/backup.sh

Anatomia de uma linha do crontab

Cada linha é uma tarefa: cinco campos de tempo, separados por espaço, e depois o comando. Este desenho é o mesmo que aparece nos comentários do /etc/crontab:

.---------------- minuto        (0 - 59)
|  .------------- hora          (0 - 23)
|  |  .---------- dia do mês    (1 - 31)
|  |  |  .------- mês           (1 - 12 ou jan, feb, mar…)
|  |  |  |  .---- dia da semana (0 - 7: 0 e 7 = domingo, 1 = segunda… ou sun, mon…)
|  |  |  |  |
*  *  *  *  *  comando a executar

30

Minuto: aos 30 minutos.

2

Hora: das 2h. Junto com o minuto: 2h30.

*

Dia do mês: qualquer um. O asterisco significa "todos".

*

Mês: qualquer um.

1-5

Dia da semana: de segunda (1) a sexta (5).

/home/ana/bin/backup.sh

O comando, com caminho completo.

Lendo tudo junto: "às 2h30, de segunda a sexta, rode o backup".

Os símbolos dos campos

Exemplos prontos

Atalhos com @

Exemplo completo: backup todo dia às 2h

1. Tenha um script que funciona. Teste no terminal primeiro:

   #!/usr/bin/env bash
   destino="/home/ana/backups/docs-$(date +%F).tar.gz"
   mkdir -p /home/ana/backups
   tar -czf "$destino" -C /home/ana Documentos
   echo "$(date '+%F %T') backup criado: $destino"

   $ chmod +x ~/bin/backup.sh
   $ ~/bin/backup.sh
   2026-10-15 10:30:00 backup criado: /home/ana/backups/docs-2026-10-15.tar.gz

2. Abra a agenda com crontab -e e acrescente no fim:

   0 2 * * * /home/ana/bin/backup.sh >> /home/ana/backup.log 2>&1

   0 2 * * *

   Todo dia às 2h00.

   /home/ana/bin/backup.sh

   O script, com caminho completo. Nada de caminho relativo: o cron não roda na pasta que você imagina. O ~ até funciona aqui, porque o /bin/sh o expande, mas não funciona nas variáveis do topo do crontab (PATH=~/bin fica literal). Na dúvida, escreva o caminho inteiro.

   >> /home/ana/backup.log

   Acrescenta o que o script escreve num arquivo de log.

   2>&1

   Manda também as mensagens de erro para o mesmo log.

3. No dia seguinte, confira o log e o registro do sistema:

   $ cat ~/backup.log
   2026-10-16 02:00:01 backup criado: /home/ana/backups/docs-2026-10-16.tar.gz
   $ grep CRON /var/log/syslog | tail -1
   2026-10-16T02:00:01.512694-03:00 notebook CRON[32051]: (ana) CMD (/home/ana/bin/backup.sh >> /home/ana/backup.log 2>&1)

   A linha do syslog prova que o cron tentou rodar o comando. Se o comando falhou, o motivo estará no seu backup.log. Por isso o redirecionamento é tão importante.

O ambiente do cron é diferente do seu terminal

Esta é a causa número 1 de "funciona no terminal, mas não no cron". O cron roda seus comandos num ambiente mínimo:

Você pode definir variáveis no topo do crontab, e elas valem para as linhas de baixo:

PATH=/usr/local/bin:/usr/bin:/bin:/snap/bin
SHELL=/bin/bash

0 2 * * * /home/ana/bin/backup.sh >> /home/ana/backup.log 2>&1

Formas diferentes de agendar

Nos arquivos de sistema, a linha tem o usuário entre o horário e o comando. Este é um trecho real do /etc/crontab do Ubuntu:

$ grep cron.daily /etc/crontab
25 6	* * *	root	test -x /usr/sbin/anacron || { cd / && run-parts --report /etc/cron.daily; }

Apagar a agenda: cuidado com o -r

$ crontab -l > ~/crontab-backup.txt
$ crontab -r
$ crontab -l
no crontab for ana                                  « a agenda inteira sumiu
$ crontab ~/crontab-backup.txt
$ crontab -l
# m h  dom mon dow   command
0 2 * * * /home/ana/bin/backup.sh >> /home/ana/backup.log 2>&1

Quando não funciona: "meu cron não roda"

Siga estes passos na ordem. Quase sempre o problema aparece até o passo 4.

1. O cron está ligado?

   $ systemctl is-active cron
   active

2. A linha está na agenda certa? Uma tarefa que precisa de root não roda na agenda da ana, e vice-versa.

   $ crontab -l
   # m h  dom mon dow   command
   0 2 * * * /home/ana/bin/backup.sh >> /home/ana/backup.log 2>&1
   $ sudo crontab -l
   no crontab for root                                 « a agenda do root é outra

3. O cron tentou executar? Procure a linha no registro:

   $ grep CRON /var/log/syslog | grep ana | tail -3
   $ journalctl -u cron --since today

   Se não houver nenhuma linha (ana) CMD, o horário está errado ou a linha tem erro.

4. O comando falhou? Sem redirecionamento, a mensagem de erro se perde. Acrescente >> /home/ana/cron.log 2>&1 e espere a próxima execução. Os erros mais comuns que aparecem no log:

   Mensagem no log	Causa	Solução
   /bin/sh: 1: node: not found	O programa está fora do PATH do cron	Use o caminho completo (which node mostra) ou defina PATH= no topo
   /bin/sh: 1: /home/ana/bin/backup.sh: Permission denied	Script sem permissão de execução	chmod +x ~/bin/backup.sh
   /bin/sh: 1: ~/bin/backup.sh: not found	Caminho com ~ ou relativo	Escreva /home/ana/bin/backup.sh
   tar: Documentos: Cannot stat: No such file or directory	O script supõe estar em outra pasta	Use caminhos absolutos dentro do script

5. Teste no mesmo ambiente do cron. Este comando roda o script com o ambiente mínimo do cron, e mostra o erro na hora:

   $ env -i HOME=/home/ana PATH=/usr/bin:/bin /bin/sh -c '/home/ana/bin/backup.sh'

$ crontab -e
"/tmp/crontab.Hk2v1Q/crontab":23: bad minute
errors in crontab file, can't install.
Do you want to retry the same edit? (y/n)

Referência rápida

Exercícios

Resumo

• Cada linha do crontab tem 5 campos de tempo (minuto, hora, dia, mês, dia da semana) e um comando.
• crontab -e edita, -l lista e -r apaga tudo sem perguntar: faça cópia antes.
• Use caminhos absolutos e redirecione a saída: >> /home/ana/log 2>&1.
• O cron tem PATH=/usr/bin:/bin, usa /bin/sh e não lê o .bashrc.
• grep CRON /var/log/syslog mostra se a tarefa rodou; o seu log mostra se deu certo.