How to debug flask.app with pycharm 2.x that's running on gunicorn

Settings > Project Settings > Python Debugger

There's an option in there to enable "gevent compatible debugging".

Then, go into your debugger settings (shortcut is through the toolbar, click the dropdown near the play/debug icons and select "Edit Configurations"

Set the "Script" to your virtualenv's isntallation of gunicorn, something like:

/Users/iandouglas/.virtualenvs/defaultenv/bin/gunicorn

Set the "Script Parameters" to something like -b 192.168.1.1:9000 app:yourappname (assuming your primary starting script is called app.py and you're refering to it as 'yourappname'

the "Working directory" will be automatically set otherwise set it to wherever your code lives: /Users/iandouglas/PycharmProjects/MyExampleApp

I have a separate config file for my gunicorn settings, which specifies a host/port but I still had to specify the -b 0.0.0.0:5001 parameter to force gunicorn to bind to all IPs on my machine on port 5001.

p.s.

One important step is to add this envvar as pointed out here

PYDEVD_USE_CYTHON=NO

My case for PyCharm 2018.1.3 Professional:

  1. Go to run/debug configurations creating-and-editing-run-debug-configurations

  2. Choose new "Python" config

  3. Script path: your_path_to_/venv/bin/gunicorn
  4. Parameters(for my case): -b :5001 --access-logfile - --error-logfile - "run:create_application()"
  5. Python interpreter: your venv python version for project
  6. Working directory: path to your project
  7. Save and press DEBUG (Shift+F9)
  8. be happy!

I was trying to debug on Pycharm 2020.2.1 and the break points weren't correctly working even though the Gevent compatible debugging was enabled. It turned out that I had to disable Cython for my run configuration via setting the environment variable as described here to make it work.

PYDEVD_USE_CYTHON=NO