Resolve SSLHandshakeException errors in Atlassian CLI 11.x

If you encounter SSLHandshakeException errors while using the Atlassian CLI (Command Line Interface) client version 11.x, follow these steps to resolve the issue. The Atlassian CLI 11.x installer comes with Java, so you don't need a separate Java installation. However, you may need to configure SSL settings to ensure smooth operation.

Setting up the ACLI_JAVA_OPTS environment variable

  1. Point to cacerts

    • Locate the cacerts file in your Atlassian CLI installation directory or another location, e.g., C:\\acli\\cacerts.

    • Set the environment variable ACLI_JAVA_OPTS to point to the cacerts file. You can reuse settings from Atlassian CLI 10.1.0.

  2. Configure the environment variable using the Windows Command Line:

    set ACLI_JAVA_OPTS="-Djavax.net.ssl.trustStore=C:\\acli\\cacerts"

After configuring the environment variable, run the CLI. If the SSLHandshakeException issue persists, ensure your cacerts file is correctly configured and try the following steps:

  • Make the environment variable permanent
    Add the ACLI_JAVA_OPTS environment variable to your system's environment variables. This ensures the CLI uses the specified cacerts file every time it runs.

  • Modify the acli.bat file
    Edit the acli.bat file to include the ACLI_JAVA_OPTS setting. This ensures the Atlassian CLI uses the specified SSL configuration every time it's launched via the acli.bat script.

Â