Kyngchaos installer is not finding python3. I installed python3 using HomeBrew and is not located at /usr/local/Cellar/python/3.6.4_4/Frameworks/Python.framework/Versions/3.6/bin/python3.6

How do I tell the QGIS installer to recognize that python3 is installed?

I had previously installed GDAL using HomeBrew, so tried reinstalling (or installing another version wherever it might end up) thinking it might help with the situation, but the QGIS3 installer still can't find python 3.

The installation error is a popup that comes up as soon as the installer is open and says "python3 QGIS requires Python 3.6."

For non Mac users, most seem to rely on Kyngchaos to provide an installer for QGIS and he has just released the installer for v3.

Update: answered my own questions below. Don't use HomeBrew unless you know enough to point the QGIS installer/QGIS to the right version (which I certainly don't), but use the python3 installer version linked to in the ReadMe.

  • Where are the Kyngchaos installers? I can't find them anywhere. – Alex Leith Mar 11 at 22:18
  • Since he hasn't updated the link, I guessed it to be – Greg Mar 11 at 22:23
  • It's not promoted on his webpage yet is it? – Alex Leith Mar 11 at 22:49
  • 2
    "QGIS 2.18.15-4" is repeated twice at and the first should be "QGIS-3.0.0-1". I think it's a copy and paste error, in other words he copied the old link etc and forgot to update. How would I guess this—not because I've ever done it! – Greg Mar 11 at 22:58
  • 4
    Today (12 Mar 2019), the link at is updated. – Greg Mar 12 at 18:47

If you have installed Python3 with Homebrew, you can use symlinks to comply with the installer needs (as suggested by @shongololo).

It seems, the installer needs Python3 installed at (thanks @shongololo): /Library/Frameworks/Python.framework/Versions/3.6/bin/python3.

(Install python3 using Homebrew to follow this part)

Find the Cellar directory on your machine. Mine is at: /usr/local/Cellar. Then find this directory: /usr/local/Cellar/python3/3.x.y_z/Frameworks/Python.framework (where 3.x.y_z is the python3 version you want to use, for me it is 3.6.4_2). This is the directory we want the installer to find. We need to link to this directory from the directory the installer is looking at by making a Symbolic Link.

Using the ln command (ln -s TARGET_FILE_TO_LINK_TO LINK_NAME): ln -s /usr/local/Cellar/python3/3.x.y_z/Frameworks/Python.framework /Library/Frameworks/Python.framework will do the trick. You certainly need to sudo.

This has worked for me.

(The "Cellar" is a place that all your "kegs" go. Homebrew installs packages to their own directory (in the Cellar) and then symlinks their files into /usr/local/. [from Ryan Kulla's blog])

  • Thanks for this info. I fixed already with "default" installer. Since I don't need Python for anything else that will work for me. I in general prefer to use Homebrew for consistency. And Apple has v2 installed by default. Was are the tradeoffs between using the two installers (Homebrew and one from the python site)? I guess that Homebrew will keep python updated more easily. And you can uninstall easily. I have no idea how to do that with the other install method. Got me thinking to go back to the Homebrew version since I know how to manage it. – Greg Mar 13 at 19:59
  • @greg homebrew is easier to much easier to manage, e.g. uninstalls. It also keeps your various package interdependencies interlinked quite nicely. – shongololo Mar 14 at 9:34
  • 1
    @evenfire thanks for the nice explanation. brew info python is a handy way to quickly find paths to existing brewed python installs – shongololo Mar 14 at 9:36
  • 4
    A heads-up that brew recently changed their default python to v3, so for those that have recently updated / upgraded their homebrew, the above paths would contain python and not python3 – shongololo Mar 14 at 10:13
  • 3
    How could I connect the framework file with anaconda python? (I cannot find python.framework in anaconda dirs) – natsuapo Mar 15 at 14:16


QGIS3 can now be installed from osgeo's homebrew tap, which saves mucking about with python symlinks... i.e. brew tap osgeo/osgeo4mac brew install osgeo/osgeo4mac/qgis3 Then type qgis3 in the terminal to launch, then pin the dock menu icon to simplify launching in future.

Note that the installation console logs will also provide an example for how to symlink qgis3 to your applications directory.


(This method requires updating symlinks when versions change... i.e. not ideal)

For those who use homebrew, it is probably better to just use a symlink, otherwise all kinds of havoc could emerge. e.g. the official python binary will modify your ~./bash_profile so that python3 and pip3 no longer point to brew...

In my case I've now symlinked the homebrew version (along the lines of the discussion in the answer provided by @Evenfire): sudo ln -s /usr/local/Cellar/python/3.6.5/Frameworks/Python.framework /Library/Frameworks/Python.framework

QGIS3 then complained that certain python packages were missing, which can be installed with pip3, e.g. pip3 install owslib PyYaml psycopg2 jinja2 pygments plotly It might also complain about gdal, in my case I simply used brew: brew install gdal


(This method is not recommended for brew users!)

I've also got python3 installed via brew and am running into the same difficulty.

What seems to work is to install the official python binaries which install to /Library/Frameworks/Python.framework/Versions/3.6/bin/python3.

From trial and error, this has to be done before the 1 Install GDAL Complete.pkg package is installed, which otherwise installs against the wrong python and QGIS 3 will complain about missing python packages.

Those with time to experiment could conceivably try symlinks to get around directly using the brew (or other) python3.

  • Thanks! The install of python just before the "1 Install GDAL Complete.pkg" did the trick for me and solved the error "module osgeo not found". – Javier Fajardo Mar 13 at 18:35
  • Do you have GDAL also installed with homebrew? I created the symlink for python but the installer is asking for GDAL2.2 which I have installed with homebrew. – Duccio A May 18 at 10:32
  • In my case I don't have gdal installed with homebrew. My understanding is that QGIS specifically depends on KyngChaos' version (unfortunately!). So it might be necessary to install the gdal provided with QGIS and then it might work. – shongololo May 18 at 13:26
  • 1
    I noticed that installing binaries for the newer python3.7 is not supported by the newest QGIS installer! python3.6.6 is necessary, and it can be downloaded from the link that you provided in this answer. – Javier Fajardo Jul 18 at 15:06
  • 1
    This might be a very stupid question, but once you've installed qgis via homebrew, how do you run it? Figured it out: qgis3 is the command. – Juan Francisco Saldarriaga Aug 20 at 17:13

I followed the link that came with the QGIS installer to and installed python3 that way. The QGIS installer was then happy.

This seems to be contradicted by comments here:

"Because QGIS links the python library, you must install the Python 3.6. You can't substitute another python 3 installation. Sorry, that's the way it is."

Posted at If I knew how to contact William Kyngesbury, I would. He is performing a great service though.

A version using pyenv and brew:

brew install pyenv
env PYTHON_CONFIGURE_OPTS="--enable-framework CC=clang" pyenv install 3.6.5
sudo ln -s /Users/$USER/.pyenv/versions/3.6.5/Python.framework/Versions/3.6 /Library/Frameworks/Python.framework/Versions/3.6
sudo cp -R /Users/$USER/.pyenv/versions/3.6.5/Python.framework/Versions/3.6 /Library/Frameworks/Python.framework/Versions/3.6
sudo cp -r /Users/$USER/.pyenv/versions/3.6.5/lib/python3.6/lib-dynload/ /Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/lib-dynload
sudo cp /Users/$USER/.pyenv/versions/3.6.5/lib/python3.6/lib-dynload/ /Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/lib-dynload/
  • it should be enough just to run first 2 lines and then ln -s ~/.pyenv/versions/3.6.5/Python.framework /Library/Frameworks/Python.framework – Alex Markov Jul 4 at 8:53

I faced the same issue when installing QGIS on mac.
It was failed, although I tried to softlink it with other python installed by anaconda, etc.
The way I solved the issue: download related python version in and install.

Your Answer

By clicking "Post Your Answer", you acknowledge that you have read our updated terms of service, privacy policy and cookie policy, and that your continued use of the website is subject to these policies.

Not the answer you're looking for? Browse other questions tagged or ask your own question.