Cron job every month: expression and example
The cron expression for on the 1st of every month 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 on the 1st of every month 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) | 1 | day 1 of the month |
| Month (1-12) | * | every month |
| Day of week (0-7, Sunday is 0 or 7) | * | every day of the week |
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. Monthly invoicing, billing runs, usage reports, archiving last month's logs. A typical line looks like this:
0 0 1 * * /srv/app/bin/run-billing >> /var/log/billing.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
- "Last day of the month" doesn't exist in cron. Run on the 1st at 00:00 and process the previous month, or run daily and check
date -d tomorrow +%dequals 01 in the script. 0 0 31 * *runs only in months with 31 days;0 0 30 * *skips February. The 1st is the only safe day.@monthlyis shorthand for this exact expression.- 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 * * /srv/app/bin/run-billing && 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. heyUptime's longest heartbeat period is one week, so a monthly job can't be watched as a plain heartbeat. Two ways round it: have the job write a "last run" date to a small web page and monitor that page with a text rule, or run the job daily and have it exit early (and still ping) unless it's the 1st, which also gives you a daily sign of life.
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 month?
0 0 1 * *: midnight on the 1st of every month. @monthly is the same.
How do I run on the last day of the month?
Cron can't express it. Run daily and exit unless tomorrow is the 1st: 0 0 * * * [ "$(date -d tomorrow +\%d)" = 01 ] && /path/to/job.
Can I monitor a monthly cron job with a heartbeat?
Not directly; heartbeat periods go up to one week. Run the job daily with an early exit on days other than the 1st (pinging on every exit 0), or have it publish a "last run" date on a page you monitor with a text rule.
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 week
- Cron job every year
- 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.