How to Install PyCharm on Debian? (With Shortcut)

Linux is often used by developers (and it’s great for it, I used it myself for years). The default editors are fine for beginners, but if you’re working on serious projects, you’ll probably look for a better alternative. Today, we’ll see how to install PyCharm on Debian.

PyCharm has both a premium and free version, available on their website. The downloaded files for Linux are already compiled, so the PyCharm IDE can be started directly by running the pycharm.sh file.

Running it once is fine, but the idea in this article is to go a bit further. I’ll show you everything you need to know in order to get the most out of it.

Install PyCharm on Debian

With Eclipse and Visual Studio, PyCharm is one of the most popular IDEs for programmers, especially when working with Python. Market share results vary too much to be considered – from 7% on the Top IDE index to 35% for JetBrains, the PyCharm editor ^^.

PyCharm is well-known in the industry, with all the best features we can expect from an IDE, that’s why we’ll learn how to install it on Debian.

Download PyCharm

PyCharm used to have two separate versions available:

• A Professional Edition, where you need a license to use it (approximately $200 a year).
• A Community Edition, which is open-source and free to use.

Recently, they’ve been combined into one software: you automatically start with a free trial of the Professional Edition, and after it runs out, you’ll be on the free Community Edition.

To download the files, you can go to this URL on the official website.

Extract the Files

You should get a tar.gz file in your Downloads folder.
Here’s how to extract the files:

• Open the file manager (there is a shortcut in the top bar).
• Go to the Downloads folder (e.g., /home/pat/Downloads).
• Find the PyCharm archive and right-click it.
• Choose “Extract Here”:

After a few moments, a new folder will be created containing all the files.
If you prefer the command line, you can also start a terminal and run:
tar -zxvf pycharm-A.B.C.tar.gz
Replace A.B.C with the version you downloaded (tip: use TAB to auto-complete the file name).

Not sure what tar is? Check this article: How to Use the Tar Command on Linux.

Make Sure Java is Installed

Before doing anything else, we need to install Java. It isn‘t necessarily installed by default on a fresh Debian system, so you might need to check this first.

You can use this command line:
sudo apt install default-jdk
Once installed, or if it’s already on your system, you can move to the next step.

First Run

As there is no installation wizard for PyCharm, you won’t find it in the main menu.
We’ll get back to this later, but for now, you can try running it from the Downloads folder:

• Open the File Manager and visit your Downloads folder (e.g., /home/pat/Downloads).
• Go into the newly extracted folder (e.g., pycharm-2026.1).
• The executable is in the bin subfolder.
• Double-click on the pycharm.sh file.
• Choose Execute when the popup window appears.

You’ll see the PyCharm loading screen and will need to accept the user agreement and data-sharing preferences. Then the interface will start:

From there you can use it as you’re used to. The goal of this tutorial isn’t to show you how to use PyCharm. If it is your first time using it, you can easily find some help from the Internet.

Improve Your PyCharm Installation

If you are used to my articles, you know that I always try to add a few bonus tips in each article. After installing PyCharm, there are at least two things you can do to improve your experience.

Move PyCharm to a Safer Location

I don’t know about you, but in my case, I consider the Downloads folder a temporary folder. You rarely need the files in it more than once. As soon as I have too many files in it, I delete everything or at least move the files into a subfolder to make sure I don’t need them.

Anyway, it isn’t a good practice to keep your applications in the Downloads folder. If there isn’t an installation wizard, it’s recommended to move them to another folder (/opt for example). This is exactly what we’ll do:

• Close PyCharm if it’s still running.
• Open a terminal.
• Run the following command:
  sudo mv ~/Downloads/pycharm-A.B.C /opt
  (Don’t forget to replace your A.B.C with the version number of your folder.)

We have to use a terminal because the default user on Raspberry Pi doesn’t have permission to write to the /opt folder.

You can now start PyCharm from /opt instead of the Downloads folder. Obviously, that’s not very convenient, so next I’ll show you how to create a shortcut in the desktop menu.

Tip: Command lines can be a pain to memorize. I put the essential Linux commands on a printable cheat sheet so you don't have to keep googling them. You can grab the PDF here if you want to save some time.

Create a Shortcut for PyCharm in the Main Menu

There is no installation wizard for PyCharm, we get the files already compiled and ready to use. It’s fine, but it doesn’t add it to the launcher on Debian.

Here is how to create your shortcut (tested with GNOME, but it’s similar with other environments):

• Open a terminal.
• Navigate to ~/.local/share/applications/ :
  cd ~/.local/share/applications/
• Create a new file for PyCharm:
  nano pycharm.desktop
• Paste the following lines:
  [Desktop Entry]
Encoding=UTF-8
Name=PyCharm
Exec=/opt/pycharm/bin/pycharm.sh
Icon=/opt/pycharm/bin/pycharm.png
Type=Application
Categories=Development;
  Obviously, you need to change the file path to fit your installation.
• Save and exit (CTRL+X).

A few seconds later, you should find the PyCharm icon in the GNOME apps launcher:

That’s it, your app files are in a safe location, and you can run your favorite text editor as if it has been installed via APT or the Software app. Enjoy!

Not getting the same result?

Even when you follow every step, small differences in OS version, hardware or config can change the outcome. Instead of wasting time guessing, get help from people who have already fixed the same kind of issue.

Ask your question now →

🔒 No risk. Cancel anytime.

• Get help on your exact issue
• Access step-by-step videos for tricky setups
• Browse the website without ads