Install Aqua

Aqua is a cross-platform IDE that provides consistent experience on the Windows, macOS, and Linux operating systems.

Aqua is free for non-commercial use. For more information, refer to Subscription options & Pricing.

System requirements

Requirement	Minimum	Recommended
RAM	2 GB of free RAM	8 GB of total system RAM
CPU	Any modern CPU	Multi-core CPU. Aqua supports multithreading for different operations and processes making it faster the more CPU cores it can use.
Disk space	3.5 GB	SSD drive with at least 5 GB of free space
Monitor resolution	1024×768	1920×1080
Operating system	Officially released versions of the following: Microsoft Windows 10 1809 64-bit or later Windows Server 2019 64-bit or later macOS 12.0 or later Two latest versions of Ubuntu LTS or Fedora Linux distributions that meet the following requirements: Linux kernel version 6.x Gnome or KDE desktop environment X Window System (X11) Wayland support is in development. You can monitor the progress and leave your feedback in JBR-3206: Native Wayland support. GLIBC 2.28 or later Pre-release versions are not supported.	The latest versions of the following: Windows 64-bit macOS Ubuntu LTS or Fedora Linux distribution

You do not need to install Java to run Aqua because JetBrains Runtime is bundled with the IDE (based on JRE 17).

Install using the Toolbox App

The JetBrains Toolbox App is the recommended tool to install JetBrains products. Use it to install and manage different products or several versions of the same product, including Early Access Program (EAP) and Nightly releases, update and roll back when necessary, and easily remove any tool. The Toolbox App maintains a list of all your projects to quickly open any project in the right IDE and version.

Install the Toolbox App

Download the installer .exe from the Toolbox App web page.
Run the installer and follow the wizard steps.
After you run the Toolbox App, click its icon in the notification area and select which product you want to install.
To install a specific version, click and select Available versions.

Log in to your JetBrains Account from the Toolbox App, and it will automatically activate the available licenses for any IDE that you install.

Install the Toolbox App

Download the disk image .dmg from the Toolbox App web page.
There are separate disk images for Intel and Apple Silicon processors.
Mount the image and drag the JetBrains Toolbox app to the Applications folder.
After you run the Toolbox App, click its icon in the main menu and select which product you want to install.
To install a specific version, click and select Available versions.

Log in to your JetBrains Account from the Toolbox App, and it will automatically activate the available licenses for any IDE that you install.

Install the Toolbox App

Download the tarball .tar.gz from the Toolbox App web page.
Extract the tarball and launch the executable:
tar -xzf jetbrains-toolbox-<build>.tar.gz && cd jetbrains-toolbox-<build> && ./jetbrains-toolbox
The Toolbox App will install itself into $HOME/.local/share/JetBrains/Toolbox/bin and run from there.
After you run the Toolbox App for the first time, it will automatically add the Toolbox App icon to the main menu.
Select the product that you want to install.
To install a specific version, click and select Available versions.

Log in to your JetBrains Account from the Toolbox App, and it will automatically activate the available licenses for any IDE that you install.

Standalone installation

Install Aqua manually to manage the location of every instance and all the configuration files. For example, if you have a policy that requires specific install locations.

Download the installer .exe.
There is a separate installer for ARM64 processors.
Run the installer and follow the wizard steps.
On the Installation Options step, you can configure the following:
- Create a desktop shortcut for launching Aqua.
- Add the directory with Aqua command-line launchers to the PATH environment variable to be able to run them from any working directory in the Command Prompt.
- Add the Open Folder as Project action to the system context menu (when you right-click a folder).
- Associate specific file extensions with Aqua to open them with a double click.

To run Aqua, find it in the Windows Start menu or use the desktop shortcut. You can also run the launcher batch script or executable in the installation directory under bin.

Download the disk image.
There are separate disk images for Intel and Apple Silicon processors.
Mount the image and drag the Aqua app to the Applications folder.

Run the Aqua app from the Applications directory, Launchpad, or Spotlight.

Download the tarball .tar.gz.
There is a separate tarball for ARM64 processors.
Extract the tarball to a directory that supports file execution.
For example, to extract it to the recommended /opt directory, run the following command:
sudo tar -xzf aqua-*.tar.gz -C /opt

Execute the aqua.sh script from the extracted directory to run Aqua.

Create a desktop entry

In the main menu, go to Tools | Create Desktop Entry.
The following steps are for Ubuntu 23.10. If you are using a different Linux distribution or version of Ubuntu, refer to its documentation.
Click Activities in the top-left corner of the screen.
Click the grid button in the dash to show all applications.
To pin the app to the dash, right-click the Aqua icon and select Add to Favorites.

When you run Aqua for the first time, you can take several steps to complete the installation, customize your instance, and start working with the IDE.

For more information, refer to Run Aqua for the first time.

Last modified: 07 November 2024