PyCharm 5.1 Help

Installing and Launching

On this page:

PyCharm editions

There are two PyCharm editions: Community and Professional.

The Community Edition is free and open source but has less features. The Professional Edition is commercial but provides an outstanding set of tools and features. (You can evaluate PyCharm Professional for free for 30 days.)

For more information, see feature-by-feature Editions comparison matrix.

Downloading and installing PyCharm

You can download the latest version of PyCharm from the JetBrains website. (There are the versions for Windows, OS X and Linux.)

Depending on your operating system:

  • Windows: Run the .exe file and follow the instructions of PyCharm Setup wizard.
  • OS X: Open the .dmg package, and drag PyCharm to the Applications folder.
  • Linux: Unpack the .tar.gz archive into any directory within your home directory.

Refer to the section Starting PyCharm on the various platforms for details.

Starting PyCharm on the various platforms

Starting PyCharm on Windows

If during the installation you selected to create a shortcut on your desktop, double-click that shortcut.

Otherwise, go to the <PyCharm>\bin folder (e.g. C:\Program Files (x86)\JetBrains\IntelliJ IDEA 14.0.2\bin) and run idea.exe or idea.bat.

See also, Importing PyCharm usage preferences from a previous version.

Starting PyCharm on OS X

If you are using the versions of Java over 6, then note that Java version specified in the file takes precedence over that specified in info.plist. If you want to change the Java version without modifying the file info.plist, you can just change the value of JVMVersion property as required, for example, JVMVersion = 1.6+.

Thus the entire procedure is:

  1. Make sure that you have an appropriate version of Java (JRE or JDK) installed. This may be Java 6 from Apple, or Java 7 or a later version from Oracle.

    (You can try to start PyCharm right away. If there is no Java on your computer, PyCharm will notify you about that.)

  2. If necessary, do the following:
    1. Copy the file from /Applications/PyCharm<version>.app/Contents/bin to ~/Library/Preferences/PyCharm<version>
    2. Open ~/Library/Preferences/PyCharm<version>/ for editing.
    3. Change JVMVersion=1.6* to JVMVersion=1.6+.
    4. Save and close the file.
  3. Go to your /Applications folder and run the PyCharm application.

See also, Importing PyCharm usage preferences from a previous version.

Starting PyCharm on Linux

Before you start

Make sure that you have an Oracle JRE or JDK version 6 or later installed on your computer. Refer to the section Installing Oracle JDK.

Launching PyCharm

To launch PyCharm on Linux, follow these steps:

  1. Download the pycharm-professional or pycharm-community-*.tar.gz file from the Download page.
  2. Unpack the pycharm-professional or pycharm-community-*.tar.gz file to an empty directory using the following command:
    tar xfz pycharm-professional or pycharm-community-*.tar.gz
  3. Because running PyCharm from wherever you downloaded the file to may be inconvenient, it is recommended that you move the extracted or unpacked archive folder to the desired location using the mv command in one of the following formats:
    • mv <path to extracted archive folder> <new archive folder>
      For example:
      mv /downloads/pycharm-professional or pycharm-community-* my/desired/location
    • mv <path to pycharm-professional or pycharm-community-*.tar.gz> <new archive folder>
      For example:
      mv /downloads/pycharm-professional or pycharm-community-*.tar.gz my/desired/location
  4. Switch to the bin directory in the new location:
    cd <new archive folder>/pycharm-professional or pycharm-community-*/bin
    For example,
    cd my/desired/location/pycharm-professional or pycharm-community-*/bin
  5. Run pycharm-professional or from the bin subdirectory.

Additional launchers

Additionally, you can create a desktop shortcut and a command-line launcher, and use them to start PyCharm:

See also, Importing PyCharm usage preferences from a previous version.

Creating a desktop shortcut

To create a desktop shortcut for PyCharm, use the Create Desktop Entry command. This command is available:

  • In the Customize PyCharm wizard - when you run PyCharm for the first time.
  • On the Welcome screen: Configure | Create Desktop Entry.
  • In the main menu: Tools | Create Desktop Entry.

You can choose to create the shortcut:

  • For all of your computer users: In this case, the jetbrains-idea.desktop entry file is created in /usr/share/applications.
  • Only for yourself: The jetbrains-idea.desktop entry file is created in ~/.gnome/apps and ~/.local/share/applications.

Importing PyCharm usage preferences from a previous version

When you start PyCharm for the first time, the Complete Installation dialog opens, and you have an option of importing PyCharm usage preferences and license information from a previous version.

Select one of the following options and click OK.

  • I want to import my settings from a previous version (<path>). If this option is present in the dialog, the directory that contains the PyCharm settings and license information is found at its default location. (The corresponding path is shown within the option name in parentheses.) Most likely, this is the option that you want.
  • I want to import my settings from a custom location. You may have the directory with the settings and license information available but not at its default location. If the option discussed above is missing, PyCharm doesn't know where this directory is; the path initially shown in the field is just a guess, and there's no guarantee that the necessary folder is really there. To import the settings in this case, you can specify the folder with the settings (if you know where it is) , or an installation folder of the previous PyCharm version. To do that, click browseButtonOneDot and select the folder in the dialog that opens .
  • I do not have a previous version of PyCharm or I do not want to import my settings. If this is your case, select this option.

See also, Exporting and Importing Settings.

See Also


Last modified: 28 January 2016