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:
| Field | Value | Meaning |
|---|---|---|
| Minute (0-59) | 0 | minute 0 |
| Hour (0-23) | 0 | hour 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) | 1 | day 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.
@weeklyis 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
dateon 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, notpython3) 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.
Related
- Cron job monitoring
- Cron job tester
- Cron job every Sunday
- Cron job every month
- Cron job every minute: expression and example
- Cron job every 5 minutes: expression and example
- Cron job every 10 minutes: expression and example
- Cron job every 15 minutes: expression and example
- Cron job every 30 minutes: expression and example
- Cron job every hour: expression and example
Updated October 8, 2026.