DEV Community

Nakul Kurane
Nakul Kurane

Posted on • Updated on • Originally published at Medium

How to Execute a Cron Job on Mac with Crontab


Before I write the steps below, I would recommend installing the latest version of Python with homebrew. Homebrew is a package manager just like pip and anaconda and frankly, I’m just using that in this example because I tried for hours to run a simple cron job to no avail. I frequently got errors about not being able to open the file I wanted to execute or not finding the installed python version. I won’t get into my errors in this post but you’re free to use any other Python installation if you like.

I uninstalled my Python 3.x versions I had installed (via pip and conda) and started from scratch — uninstalling was also a hassle. So let’s say you’re on your Mac and have the default Python distribution which I believe should be 2.7.10. Few to no developers are updating modules in this version so when you’re building projects, it’s best to have the latest version of Python installed.

I followed Real Python’s guide to install Python 3 via Homebrew (a quick few steps really) so I will assume you have done the same going forward in this post.


Open up your Terminal command prompt on your Mac and navigate to the home directory by running cd ~/

For me, it is Users/Nakul

We will be using Mac OS’s in-built crontab feature to write our cron jobs.

Type crontab -e and press Enter.

This should open up an empty file, this is where you will write your cron jobs. You can write the job to run a shell script or a Python script in this case.

Type :q! to exit the editor.

Assuming you followed the Homebrew guide above, double check your Python installation path. You can do so by typing which python3 in your Terminal. It should display /usr/local/bin/python3 (which is an alias for the actual homebrew installation location but that’s fine, we won’t go into that right now). You will include this path in your cron job syntax, which we’ll get into.

Before we write our cron job, we should have a script which we want to run.

I’ve already created a directory /Documents/Python/cron in my home directory and created a simple script called

Note: this Python script needs to be executable so change the permissions on it to allow for that, I just ran a chmod 777

The script simply creates a directory with the current date and time as the name.

The script text is as follows if you want to use the same script:

Enter fullscreen mode Exit fullscreen mode



from datetime import datetime
import os
sysDate =

convert system date to string

curSysDate = (str(sysDate))

parse the date only from the string

curDate = curSysDate[0:10]

parse the hour only from the string

curHour = curSysDate[11:13]

parse the minutes only from the string

curMin = curSysDate[14:16]

concatenate hour and minute with underscore

curTime = curHour + ‘_’ + curMin

val for the folder name

folderName = curDate + ‘_’ + curTime

make a directory


Enter fullscreen mode Exit fullscreen mode

You might wonder what that first line #!/usr/bin/python3 is. That line is referred to as a shebang and how the cron job will interpret the script so in this case it will run the with Python (as if you executed python in your Terminal).

Ok, so we have Python 3.x installed, we have a Python script, now let’s write the cron job to run this!

Let’s say we want to run this script every minute (mostly for the purpose of testing on your end so you can see the results without waiting too long).

The cron job syntax is as follows:

*/1 * * * * cd ~/Documents/Python/cron && /usr/local/bin/python3 >> ~/Documents/Python/cron/cron.txt 2>&1

What does the above mean? Let’s analyze it quickly.

*/1 * * * * simply means that the job will run every minute.

cd ~/Documents/Python/cron && /usr/local/bin/python3 navigates to the directory where the script you want to execute is located and specifies to use Python instead of Bash to execute (since it is a Python script, also remember that we added the shebang within the script, I found that it needed to be in both places to work). is the script filename.

>> ~/Documents/Python/cron/cron.txt specifies where to output the logs in case the execution of the job has any issues.

2>&1 simply disables email because by default, the cron job will try to send an email but we don’t have an address specified.

Anyway, that should be enough to get you writing and testing your scripts, so go on!

Feel free to browse the web to learn more about cron jobs and crontab. I decided to write this for those who have a fundamental understanding of programming and wanted to write a cron job as soon as possible.

Hope this helped; go write some jobs!
Find me on the web:

Follow on LinkedIn

Top comments (0)