PyCharm 2021.3 Help

Update PyCharm

By default, PyCharm is configured to check for updates automatically and notify you when a new version is available. Updates are usually patch-based: they are applied to the existing installation and only require you to restart the IDE. However, sometimes patch updates are not available, and a new version of PyCharm must be installed.

When PyCharm updates to a new major release, it opens the What's New in PyCharm tab in the editor with information about the changes, improvements, and fixes. To open this tab manually, select Help | What's New in PyCharm.

If PyCharm does not have HTTP access outside your local network, it will not be able to check for updates and apply patches. In this case, you have to download new versions of the IDE and install them manually as described in Standalone installation. On macOS, you can delete the outdated version of PyCharm from Application and then drag the newly installed version to Application.

Toolbox App

If you installed PyCharm using the Toolbox App, it will suggest you to update the IDE when a new version is available.

Automatically update all managed tools

  1. Open the Toolbox App and click The screw nut icon in the top right corner.

  2. In the Toolbox App Settings dialog, expand Tools and select Update all tools automatically.

If you disable this option, you will need to click Update next to any instance when a newer version comes out.

You can also configure the update policy for every managed IDE instance separately.

Configure the update policy for a specific instance

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

  2. In the instance settings dialog, select the update channel to use for this IDE instance:

    • Update to Release: Update only to stable releases that are recommended for production.

    • To Release and Early Access Program: Includes updates to release candidates, beta releases, and EAP builds, which are not recommended for production and include feature previews.

Standalone instance

If you installed PyCharm manually, the standalone IDE instance will manage its own updates. It will notify you when a new version is available (show you a notification in the Event Log tool window). You can choose to update the current instance, download and install the new version as a separate instance, postpone the notification, or ignore the update entirely.

Platform and Plugin Updates

Configure the update policy

To manage the PyCharm update policy, open Settings/Preferences Ctrl+Alt+S and select Appearance & Behavior | System Settings | Updates.

The Updates page contains the following settings:

Item

Description

Check IDE updates for

Select whether you want PyCharm to check for updates automatically and choose an update channel.

  • Early Access Program: Provides all updates, including major version EAP builds and minor version Preview builds. This channel is not recommended for production development.

    PyCharm can be updated only to a minor Preview version, but not to a major EAP build. For example, you can update PyCharm 2021.1.1 to 2021.1.2, but not to 2021.2 EAP. The 2021.2 EAP version in this case will be installed as an additional instance.

    EAP versions can be updated to both newer EAP and stable PyCharm versions. If an EAP version is updated to a stable version at some point, the name of the original installation directory does not change.

  • Beta Releases or Public Previews: Includes stable releases, release candidates, and beta releases. Some updates in this channel may contain minor bugs and feature previews.

  • Stable Releases: Includes only stable releases that are recommended for production.

Check for plugin updates

Select whether you want PyCharm to check for new versions of plugins automatically.

Check for Updates

Check for updates immediately.

Manage ignored updates

Show the list of updates that were ignored. These updates will not be suggested until you remove them from the list of ignored updates.

Show What's New in the editor after an IDE update

Open a tab with information about new features and improvements after a major IDE update.

Snap package

If you installed PyCharm as a snap package, it will manage updates automatically. All snaps are updated automatically in the background every day. You can also get the latest version of all snaps manually at any time by running the following command:

sudo snap refresh

Or if you want to update only the PyCharm snap:

sudo snap refresh <pycharm-professional,·pycharm-community, or·pycharm-educational>
Last modified: 24 November 2021