Intellij Ubuntu Installation: Complete Setup Guide

Installing IntelliJ IDEA on Ubuntu gives you a fast, production-ready environment for Java, Kotlin, Python, and web development. While standard software centers offer basic versions, installing the IDE correctly via the official tarball or the Toolbox App ensures you get the exact edition you need with proper desktop integration and automatic updates.

You don't need obscure PPA repositories or outdated packages to get started. Modern Linux distributions support direct archive extraction or managed installations through JetBrains Toolbox, which avoids common dependency conflicts and permission errors.

Prerequisites and System Preparation

Before installing IntelliJ IDEA, verify that your Ubuntu machine meets the hardware and software baselines. Running a heavy integrated development environment smoothly requires adequate resources.

• Ubuntu 22.04 LTS, 24.04 LTS, or newer (64-bit).
• At least 4 GB of RAM dedicated to the system, with 8 GB or more recommended.
• 2.5 GB of free disk space for the IDE installation and project caches.
• A compatible Java Development Kit (JDK) if you plan to build Java applications.

Check your Ubuntu architecture and installed Java version by opening your terminal and running these commands:

uname -m
java -version

If Java isn't installed or you need a modern runtime like OpenJDK 17 or 21, install it via the official package manager:

sudo apt update
sudo apt install openjdk-21-jdk

Method 1: Installing via JetBrains Toolbox App

The JetBrains Toolbox App is the cleanest way to manage IntelliJ IDEA on Ubuntu. It handles installations, automatic updates, version rollbacks, and multiple parallel editions (Ultimate and Community) without cluttering your system directories.

1. Go to the JetBrains Toolbox App download page and grab the official Linux tarball.
2. Extract the downloaded archive in your downloads directory using the terminal:

tar -xzf ~/Downloads/jetbrains-toolbox-*.tar.gz -C ~/Downloads/

3. Navigate into the extracted folder and run the binary application file to launch the Toolbox interface:

cd ~/Downloads/jetbrains-toolbox-*/
./jetbrains-toolbox

4. Follow the graphical setup wizard. Once the Toolbox dashboard opens, find IntelliJ IDEA Community Edition or IntelliJ IDEA Ultimate and click Install.

The Toolbox app automatically places the application launcher in your Ubuntu application menu and manages background updates securely within your user profile directory.

Method 2: Manual Installation via Tarball

If you prefer a manual setup without background helper applications, you can download the standalone archive and configure the desktop shortcut yourself.

1. Visit the IntelliJ IDEA Downloads page and copy the direct link for the Linux tar.gz package.
2. Download the archive directly into your system using wget:

wget https://download.jetbrains.com/idea/ideaIU-2024.1.tar.gz -O ~/Downloads/intellij.tar.gz

3. Create an installation directory under /opt or unpack it inside your home directory. Extract the contents:

sudo mkdir -p /opt/intellij
sudo tar -xzf ~/Downloads/intellij.tar.gz -C /opt/intellij --strip-components=1

4. Launch IntelliJ for the first time by running the startup script from the terminal:

/opt/intellij/bin/idea.sh

Configuring Desktop Integration

Manual installations don't automatically create desktop application shortcuts or terminal commands. You can configure these manually so IntelliJ appears in your Ubuntu Activities overview.

Create a custom desktop entry file using a text editor:

nano ~/.local/share/applications/intellij.desktop

Paste the following configuration block into the file, save it, and exit:

[Desktop Entry]
Encoding=UTF-8
Name=IntelliJ IDEA
Comment=Capable and Ergonomic IDE for JVM
Exec=/opt/intellij/bin/idea.sh
Icon=/opt/intellij/bin/idea.png
Terminal=false
Type=Application
Categories=Development;IDE;

Make the desktop file executable:

chmod +x ~/.local/share/applications/intellij.desktop

You can now search for IntelliJ IDEA directly in your Ubuntu dash and pin it to your dock.

Optimizing Performance on Ubuntu

Out-of-the-box settings are fine for small projects, but heavy enterprise codebases require tuning to prevent lag, high memory consumption, or sluggish indexing.

Adjusting JVM Heap Size

If your IDE freezes or triggers frequent garbage collection pauses, increase the maximum heap size allocated to the JVM.

1. Open IntelliJ and go to Help > Edit Custom VM Options...
2. Modify or add the following flags based on your system RAM:

-Xms512m
-Xmx2048m
-XX:ReservedCodeCacheSize=512m

Enabling Wayland or X11 Display Fixes

Ubuntu defaults to Wayland display servers, which can occasionally cause scaling issues or input lag in Java Swing applications. If you experience visual artifacting, force the IDE to run on XWayland or native Wayland by editing your custom properties or launching with environment flags.

Common Installation Pitfalls

• Permission Denied Errors: Never run manual tarball extractions or IDE launch scripts with sudo unless you are placing files into system-wide directories like /opt. Running the IDE as root corrupts configuration permissions in your home directory.
• Missing JDK Path: If IntelliJ fails to detect your installed Java SDK, configure it manually via File > Project Structure > SDKs, pointing it to /usr/lib/jvm/java-21-openjdk-amd64.
• File Watcher Limits: Linux limits the number of files an application can monitor simultaneously. If you encounter file synchronization warnings in large monorepos, increase the system watch limit:

echo "fs.inotify.max_user_watches=524288" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

Frequently Asked Questions

What is the difference between IntelliJ Community and Ultimate?

The Community edition is free and open-source, ideal for Java, Kotlin, Groovy, and Android development. The Ultimate edition is commercial and adds advanced tools for enterprise frameworks, Spring, databases, TypeScript, and web development.

How do I update IntelliJ manually?

If you installed via the standalone tarball, download the new archive from JetBrains, extract it, and replace the contents of your existing installation directory while keeping your user configuration folders intact. Using the Toolbox App automates this entirely.

Can I run multiple versions of IntelliJ side by side?

Yes. Using the JetBrains Toolbox App allows you to install and run major point releases (such as version 2024.1 and 2024.2) simultaneously on the same Ubuntu system without configuration clashes.