Ultimate
Run tasks of manage.py

Last modified: 01 August 2022

warning

The following is only valid when the Python plugin is installed and enabled.

Overview

With IntelliJ IDEA, 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 facet page of the Project Structure dialog.

To configure manage.py utility, follow these steps

  1. In the Project Structure dialog, click the module with Python support, and add Django facet.

  2. Click the Django facet.

  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 IntelliJ IDEA 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.

    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

IntelliJ IDEA 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

External Links