PyCharm 2021.2 Help

Increase the memory heap of the IDE

The Java Virtual Machine (JVM) running PyCharm allocates some predefined amount of memory. The default value depends on the platform. If you are experiencing slowdowns, you may want to increase the memory heap.

  1. From the main menu, select Help | Change Memory Settings.

  2. Set the necessary amount of memory that you want to allocate and click Save and Restart.

This action changes the value of the -Xmx option used by the JVM and restarts PyCharm with the new setting.

PyCharm also warns you if the amount of free heap memory after a garbage collection is less than 5% of the maximum heap size:

low memory warning

Click Configure to increase the amount of memory allocated by the JVM. If you are not sure what would be a good value, use the one suggested by PyCharm.

The Memory Settings dialog

Click Save and Restart and wait for PyCharm to restart with the new memory heap setting.

Enable the memory indicator

PyCharm can show you the amount of used memory in the status bar. Use it to judge how much memory to allocate.

  • Right-click the status bar and select Memory Indicator.

Toolbox App

If you are using the Toolbox App, you can change the maximum allocated heap size for a specific IDE instance without starting it.

  1. Open the Toolbox App, click The screw nut icon next to the relevant IDE instance, and select Settings.

  2. In the instance settings dialog, expand Configuration and specify the heap size in the Maximum heap size field.

If the IDE instance is currently running, the new settings will take effect only after you restart it.

If you are using a standalone instance not managed by the Toolbox App, and you can't start it, it is possible to manually change the -Xmx option that controls the amount of allocated memory. Create a copy of the default JVM options file and change the value of the -Xmx option in it.

Memory parameters specific to a particular service, for example, Docker can be modified through the corresponding run/debug configurations.

Last modified: 12 August 2021