Aqua Help

Update Aqua

By default, Aqua is configured to check for updates automatically and notify you when a new version is available. Updates are usually patch-based: they are applied to the existing installation and only require you to restart the IDE. However, sometimes patch updates are not available, and a new version of Aqua must be installed.

If Aqua does not have HTTP access outside your local network, it will not be able to check for updates and apply patches. In this case, you have to download new versions of the IDE and install them manually as described in Standalone installation.

Toolbox App

If you installed Aqua using the Toolbox App, it will suggest that you update the IDE when a new version is available.

Automatically update all managed tools

  1. Open the Toolbox App and click the Toolbox App menu icon in the top right corner.

    Toolbox App menu icon
  2. In the Toolbox App Settings dialog, expand Tools and select Update all tools automatically.

If you disable this option, you will need to click Update next to any instance when a newer version comes out.

You can also configure the update policy for every managed IDE instance separately.

Configure the update policy for a specific instance

  1. Open the Toolbox App, click The three dots icon next to the relevant IDE instance, and select Settings.

  2. In the instance settings dialog, select the update channel to use for this IDE instance:

    • Release: Update only to stable releases that are recommended for production.

    • Early Access Program: Includes updates to release candidates , beta releases, and EAP builds, which are not recommended for production and include feature previews.

Standalone instance

If you installed Aqua manually, the standalone IDE instance will manage its own updates. It will notify you when a new version is available. You can choose to update the current instance, download and install the new version as a separate instance, postpone the notification, or ignore the update entirely.

Configure the update policy

To manage the Aqua update policy, open Settings Ctrl+Alt+S and select Appearance & Behavior | System Settings | Updates.

The Updates page contains the following settings:

Item

Description

Check IDE updates for

Select whether you want Aqua to check for updates automatically and choose an update channel.

  • Early Access Program: Provides all updates, including major version EAP builds and minor version Preview builds.

    EAP versions can be updated to both newer EAP and stable Aqua versions. If an EAP version is updated to a stable version at some point, the name of the original installation directory does not change.

  • Stable Releases: Includes only stable releases that are recommended for production.

Check for plugin updates

Select whether you want Aqua to check for new versions of plugins automatically.

Check for Updates

Manually check for updates immediately. If there are updates available, you will see the same dialog as when the IDE checks for updates automatically.

Manage ignored updates

Show the list of updates that were ignored. These updates will not be suggested until you remove them from the list of ignored updates.

Last modified: 15 May 2024