Run tasks of manage.py

Last modified: 08 March 2021

This is a Professional feature: download PyCharm Professional to try.

Overview

With PyCharm, you can run Django manage.py utility from within the IDE. Each task of this utility is executed in the manage.py console.

Note that Run manage.py task command is available for both local and remote interpreters.

Configuring manage.py utility

It's important to note that configuration of the manage.py utility is done in the Django page of the Settings/Preferences dialog.

To configure manage.py utility, follow these steps

  1. In the Settings/Preferences dialog Ctrl+Alt+S under the Languages and Frameworks node, click Django.

  2. In this page, choose the desired Django project.

  3. In the Manage.py tasks section, specify the following:

    • In the field Manage script, specify the desired manage.py script.
      Note that by default PyCharm shows the manage.py script that resides under the Django project root. If you are not happy with this suggestion, you can choose any other manage.py script by clicking the browse button the Browse button.

    • In the Environment variables field, specify the environment variables to be passed to the script. By default, this field is empty.

      Click the browse button the Browse button to open the Environment Variables dialog box. Use the toolbar buttons to make up the list of variables.

      If you want to see the system environment variables, click Show link in this dialog box.

Running manage.py utility

To run a task of the manage.py utility

  1. On the main menu, choose Tools | Run manage.py task, or press Ctrl+Alt+R.

    The manage.py utility starts in its own console.

  2. Type the name of the desired task.

Working in the manage.py utility console

In the manage.py console, one can:

Handling error

PyCharm smartly handles errors. When your Django project can't run due to an error, this error displays in the manage.py console instead of the command line:

Py managepy error

See also

Reference

External Links