How to change the wrong encoding in Bamboo that is causing crashes or characters to display incorrectly

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.


  1. You are trying to create a Jira issue from Bamboo and it crashed
  2. Code changes with special characters such as umlauts are replaced with different characters
  3. Angled brackets in the UI are replaced with different characters
  4. The build logs are getting cluttered with different characters
  5. Errors regarding Illegal characters. For example:
error 19-Jul-2022 10:12:34 java.nio.file.InvalidPathException: Illegal char <?> at index 41: Sample ? filename.txt


The system character encoding is wrong with the expected being UTF8


  1. Shutdown Bamboo

  2. Edit $BAMBOO_INSTALL/bin/ (.bat for Windows or follow this article if you are starting as a service)

  3. Add this line in quotes under JVM_SUPPORT_RECOMMENDED_ARGS=

    -Dfile.encoding=utf-8 -Dsun.jnu.encoding=utf-8
  4. Restart Bamboo and check that your system encoding changes to utf-8 from the System information page.

If the issue is manifesting on your remote agents, e.g. the the build logs are replacing utf-8 characters with question marks or there are errors about illegal characters in your builds that occur on a remote agent: 

  1. Shutdown the remote agent
  2. Edit $BAMBOO_AGENT_HOME/conf/wrapper.conf
  3. Add the below lines:
    Please replace the # with the next available digit in the series of java additionals. The numbers must be sequential for the argument to apply.
  4. Restart the agent and check that your system encoding changes to utf-8 from the general configuration page.

Last modified on Aug 19, 2022

Was this helpful?

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