Latest Code Tutorials

Setup Django Mac: How To Install Django On Mac

In this tutorial, I will show you How To Install Django On Mac. Django is available open-source under the BSD license. We recommend using the latest version of Python 3. If you plan to use Django’s database API functionality, you’ll need to ensure a database server is running. Django supports many different database servers and is officially supported with PostgreSQLMariaDBMySQLOracle, and SQLite.

What is Django Framework

Django is the web framework developed in Python. Django is the high-level Python Web framework that encourages rapid development and clean, pragmatic design. It takes care of much of a hassle of Web development, so you can focus on writing your app without needing to reinvent the wheel. In addition, it is free and open-source.

Virtual Environments keep project dependencies mostly isolated from one another. Therefore, I recommend that for each project you create, you use a different virtual environment. Below, we use the virtual environment manager Pipenv.

PIP, or Python Package Installer, allows you to install all types of Python-related software (and code) include Django, virtual environments (virtualenv, pipenv, etc.), Flask, Tensorflow, Python Requests, and more.

Some of the advantages of the Django framework are as follows.

Advantages of Django Framework

  1. Ridiculously fast.
  2. Reassuringly secure.
  3. Exceedingly scalable.
  4. Incredibly versatile.
  5. Fully loaded.

How To Install Django on Mac

To install Django on mac, we have to follow the below steps.

  1. If you have not installed Python 3, then please install Python 3.
  2. Install pip or upgrade pip.
  3. Install virtual environment package virtualenv to isolate the Django project.
  4. Install the Django framework using pip.

We often come across various tutorials for separate technologies but not a precise, compact form of it. In this article, I aggregate the basic setup needed to start a Python-Django project on macOS X.

Here we will be creating a virtual environment on your system which will contain your project with python3.6 and django2.0. Well, we will install it from scratch. First, I will show you how to install Python on Mac, then how to install virtualenv, and then we install Django on that virtual environment.

Step 1: Install Python on Mac.

Python is already installed on a brand new Mac, but its version is old. So what we do is to install the latest version of python using homebrew.

brew install python3

Okay, after it will complete the installation, you will type the following command to check the version. First, type python3 in your terminal. Since MacOS X already has python installed, we cannot uninstall the old version because otherwise, the Python 2 supported programs will be stopped, and we need to reinstall the mac. So we need to type python3 instead of python.


It will display the version, and now we can execute the python code. I am using iTerm2, so your terminal may be different, but it does not matter with any commands anyway.

how to install python in mac

Okay, so we have successfully installed python 3. Now, to out from the python console, we need to type exit().

Step 2: Install Pip package management system.

Pip is the package management system used to install and manage software packages written in Python. Now, install it using the following command.

sudo easy_install pip

Step 3: Install virtualenv for python.

Now, type this command in your terminal.

sudo pip install virtualenv

Okay, after installing, we need to create a virtual environment. Now you will create this folder when you are putting your other projects. Mine is desktop >> code folder. So navigate to that and type the following command. In my case, My virtualenv folder name is thanos.

virtualenv thanos

Okay, so it will install the required folders. Now, go into that folder.

cd thanos

Now, activate the virtual environment by typing the following command. First, please Make sure you are in the virtual environment directory.

source bin/activate

You will see what your terminal looks like below.

Create Virtual Environment in Python

So, our virtual environment has been started. Now, this is the time to install the Django Framework.

Step 4: Install Django On Mac

Okay, now stay in that folder and install Django using the following command.

The latest official version is 3.0.1. First, read the 3.0.1 release notes, then install it with pip:

sudo pip install django==3.0.1

It will download the Django project. Check the Django version using the following command.

python -m django --version

In our case, we have explicitly defined that we are installing 3.0.1. So it will display that version.

Step 5: Create the Django Project.

We need to install the skeleton of the Django project.

So type the following command.

django-admin startproject thanosback

Here, our project name is thanosback. So, next, go into that folder.

cd thanosback

Finally, we have created the project. Now start the project server by typing the following command.

python runserver

python django tutorial

It has started the development server, and we can access it via localhost:8000

Navigate to the browser, and you will see a screen like this.

django rest framework tutorial

Step 6: Open Django on Visual Studio Code.

If you have not installed Visual Studio Code on Mac, then please check out my below tutorial. 

Related Post:  How To Install Visual Studio Code On Mac

This step is optional because if you are using Visual Studio Code, then it will be helpful to you.

If you are using another IDE like pycharm or editor like sublime text, then you can skip this step. But, first, perform the following step.

Install the Python extension.

Now, open our project in the visual studio code using the following command.

code .

Please make sure you are at the root of the thanosback folder.

You will get the folder structure like this.

django tutorial

Get the latest development Django version.

The latest and greatest Django version is the one that’s in our Git repository (our revision-control system).

This is only for experienced users who want to try incoming changes and help identify bugs before an official release. Get it using this shell command, which requires Git:

Type the following command to get the development version.

git clone

That’s it for this tutorial.

See also

Install Visual Studio Code on Mac

Top 5 Code Editors In 2020

  1. kaixing says

    python migrate is not working
    (myproject) Teen-MacBook-Air:myproject chok$ python runserver
    python: can’t open file ‘’: [Errno 2] No such file or directory

    1. Hero David says

      are you in you project folder
      you can use “ls” to check

    2. elmizan says

      always execute with python3 if you has been install it with that version. By default, Mac always use the old version (2.x)

  2. Charlie El says

    You saved my day, thank you so much!!

    1. Krunal says

      Thanks man!!

  3. Awais Tariq says

    Hi, Very helpful indeed.
    Can you help me in setting up MSSQL Connection from Python 2.7, Django 1.8 using Virtual Env?
    I have tried whatever I could find on internet with no help.

  4. David Adler says

    I’m confused. You install python3 but then use “python” and “pip”. When I used “pip install django=2.03”
    , it wanted to install django v1 for python 2. I had to use “python3” and “pip3”. Did I miss something about getting “python” to actually invoke “python3”?

    1. Mike Rowan says

      I have installed Python3 (machine already has 2.7).
      Thanks for your work, but I got a problem.

      When I do “sudo easy_install pip” it returns
      “Processing pip-9.0.2-py2.7.egg”

      This seems to be not what I want.

      How do I make it use Python3 ?

      1. ibarra says

        When you install virtualenv, make sure you use `pip3` or else it would be using the mac default python 2.7.

        $ pip3 install virtualenv

        When you use the virtualenv command, it would use python3. Note: you might have to uninstall and reinstall, in case you previously installed virtualenv with v.2.7

  5. Sudeep says

    Traceback (most recent call last):
    File “”, line 14, in
    import django
    ModuleNotFoundError: No module named ‘django’

    During handling of the above exception, another exception occurred:

    Traceback (most recent call last):
    File “”, line 17, in
    “Couldn’t import Django. Are you sure it’s installed and ”
    ImportError: Couldn’t import Django. Are you sure it’s installed and available on your PYTHONPATH environment variable? Did you forget to activate a virtual environment?

    I am getting this error

  6. Nithin Gangadhar says

    File “”, line 16
    ) from exc
    SyntaxError: invalid syntax
    (Django) Admins-MacBook-Pro:button apple$ python runserver
    File “”, line 16
    ) from exc
    SyntaxError: invalid syntax

  7. Max says

    you are mixing up with preinstalled Python (2) and Python3.

    Command should be updated described here

  8. badbanana says

    using “virtualenv”, how would you install different versions of python on a single system?

    you can’t. if your projects require different versions of python, only “pyenv” can provide that.

  9. Hande Yıldırım says

    Thank youuuu!!!!!! it was really helpful

    1. Krunal says

      Thanks!! Keep Sharing.

  10. Jean Boisvert says

    Breaks soon! “sudo easy_install pip” gives “invalid syntax error”. Three days spent at trying to install pip and then django, after successfully importing Python 3.8 end then 3.9. I fear there will be a fourth one!
    Why is it so difficult to work with the terminal??? Why? Why? Why? Always tons of “…not found”. Apple and Python are so “wonderfull” and so “user dedicated” that they should provide “Download, click and use.”

  11. Just Some Guy says

    Thank-you for your concise tutorial. I had ruined a django install by installing Pihole as part of a larger server app. I couldn’t repair my django installation after the server crashed until I followed this tutorial exactly.
    I think that I will recommend you most highly and look forward to your future posts.

Leave A Reply

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.