Bamboo remote agent fails to connect with SSLException: Unsupported or unrecognized SSL message

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible


Bamboo remote agent fails to connect with SSLException: Unsupported or unrecognized SSL message.


You may see the below error message in the $BAMBOO_AGENT_HOME/atlassian-bamboo-agent.log file

INFO   | jvm 1    | 2023/02/02 13:13:12 | Unsupported or unrecognized SSL message
INFO   | jvm 1    | 2023/02/02 13:13:12 |       at ~[?:?]

Cause Unsupported or unrecognized SSL message can occur if protocols on the connection address are incorrect.   For example, if you specify a port that is NOT SSL but you choose settings that try to connect via SSL, this can occur.  It is the equivalent of trying to browse HTTPS protocol on a webserver port that is only listening for HTTP protocol.

You can check the configuration on the  Bamboo's Base URL and Broker client URL  in the Administration → Overview → System, select the General configuration page


  1. Verify the configuration of the Bamboo's Base URL and Broker client URL  are with the correct protocol in use. If necessary update the value and restart Bamboo Server.
  2. Please check the Bamboo Base URL or the page  Installing a remote agent and  Running a remote agent section to find the correct URL for remote agent installation. Ensure this address is reachable by the server you're running the remote agent from.
  3. Verify and if necessary update the $BAMBOO_AGENT_HOME/conf/wrapper.conf file and adjust the<bamboo-server-URL>/agentServer/ with the correct value and protocol. 
  4. Restart the Bamboo Remote Agent

 Please check the below articles for securing Bamboo server and Bamboo remote agent.

Last modified on Nov 8, 2023

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.