Install Aqua
Aqua is a cross-platform IDE that provides consistent experience on the Windows, macOS, and Linux operating systems.
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 64-bit versions of the following:
Pre-release versions are not supported. | Latest 64-bit version of Windows, macOS, or Linux (for example, Debian, Ubuntu, or RHEL) |
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.
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 to a directory that supports file execution.
For example, if the downloaded version is 1.17.7391, you can extract it to the recommended /opt directory using the following command:
sudo tar -xzf jetbrains-toolbox-1.17.7391.tar.gz -C /optExecute the jetbrains-toolbox binary from the extracted directory to run the Toolbox App.
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.
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
PATHenvironment 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.
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.
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
Create a desktop entry
On the Welcome screen, click
Options Menu | Create Desktop Entry.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.