Skip to content
Cron schedules

Cron job every week: expression and example

The cron expression for every week: Monday at midnight is 0 0 * * 1. Put it at the start of a crontab line, followed by the command. Below: what each of the five fields does, a sample line you can copy, the mistakes people make with this schedule, and how to get told when the job doesn't run.

The expression

A cron expression has five fields separated by spaces: minute, hour, day of month, month, day of week. An asterisk means "every"; a number means "only this one"; */n means "every nth"; a-b is a range and a,b is a list. For every week: Monday at midnight the fields are:

FieldValueMeaning
Minute (0-59)0minute 0
Hour (0-23)0hour 0
Day of month (1-31)*every day of the month
Month (1-12)*every month
Day of week (0-7, Sunday is 0 or 7)1day 1: Monday

Example crontab line

Open the crontab with crontab -e and add one line: the expression, a space, then the command exactly as you'd type it in a shell. Weekly reports, rotating API keys, archiving last week's data, sending customers a weekly summary. A typical line looks like this:

0 0 * * 1 /usr/bin/python3 /srv/app/weekly_report.py >> /var/log/weekly.log 2>&1

The >> file 2>&1 at the end sends both normal output and errors to a log file. Without it, cron tries to email the output to the user, which usually means it's lost.

Gotchas

  • "Every week" has to pick a day. @weekly is Sunday at midnight (0 0 * * 0); this page uses Monday because weekly reports usually cover Monday to Sunday.
  • There are 52 or 53 runs a year; a report "for last week" should compute its own date range rather than assume seven days since the last run.
  • Timezone: cron uses the server's system timezone, which on most cloud servers is UTC. Run date on the server to see what "now" means to cron.
  • Environment: cron runs with a minimal PATH and no shell profile. Use full paths (/usr/bin/python3, not python3) and set any variables at the top of the crontab.
  • Output: if a job prints anything and there's no redirect or MAILTO, cron tries to send mail. Set [email protected] at the top of the crontab or redirect output to a log.
  • Silence: cron does not tell you when a job fails or never starts. A job that errors every run looks exactly like a job that runs fine, unless something is watching for it.

Know when it didn't run

In short: Append && curl -fsS https://heyuptime.com/ping/<token> to the line, create a heartbeat monitor with a 1 week period and 1 hour grace, and you're alerted when the job is late.

A heartbeat monitor in heyUptime is a URL your job calls when it finishes. Because of the &&, the ping is only sent when the command exits successfully, so a crashing job and a job that never started look the same: no ping. The watched line for this schedule is 0 0 * * 1 /usr/bin/python3 /srv/app/weekly_report.py && curl -fsS https://heyuptime.com/ping/<token>.

Set the heartbeat's period to 1 week and the grace to 1 hour. If a ping doesn't arrive within period plus grace, you get an alert by email, Slack, Discord, Teams or Telegram that says when the job was last seen.

To try it before signing up, the free cron job tester gives you a temporary URL for 24 hours; add it to the line and watch the ping arrive.

Questions

What is the cron expression for once a week?

0 0 * * 1 runs every Monday at midnight. Pick any day-of-week number from 0 (Sunday) to 6 (Saturday). @weekly is Sunday midnight.

How do I run every two weeks?

Cron can't count fortnights. Run weekly and have the script exit early on alternate weeks (for example, when the ISO week number is odd).

What is the longest heartbeat period heyUptime supports?

One week. For a job that runs less often than weekly, see the monthly and yearly pages for the workaround.

Watch this job for free.

Create a heartbeat with a 1 week period, add one curl to the crontab line, and get told the first time it doesn't run. 14-day trial, no card.

Watch this job free

Updated October 8, 2026.