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.
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:
Pre-release versions are not supported. | The latest versions of the following:
|
You do not need to install Java to run Aqua because JetBrains Runtime is bundled with the IDE (based on JRE 17).
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.
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.
Download the disk image .dmg from the Toolbox App web page.
note
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.
note
The Toolbox App is packaged in AppImage and requires FUSE to run.
If your distribution doesn't use the
libfuse2
package, install it by running the following command:$sudo apt install libfuse2
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.
note
If you installed Aqua via the Toolbox App, you can find the installation directory in the app: open the settings of the IDE instance in the Toolbox App, expand Configuration, and look for the Install location field.
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.
note
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.
note
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.
note
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
warning
Do not extract the tarball over an existing installation to avoid conflicts. Always extract it to a clean directory.
Execute the aqua.sh script from the extracted directory to run Aqua.
In the main menu, go to Tools | Create Desktop Entry.
note
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.
Thanks for your feedback!