How to configure UTF-8 encoding on Windows remote agents
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
Summary
This document will help you to configure UTF-8 encoding on Windows remote agents.
Environment
Bamboo agents running on Windows OS.
Solution
- Shutdown the remote agent
- Edit
$BAMBOO_AGENT_HOME/conf/wrapper.conf Add the below lines:
wrapper.confwrapper.java.additional.#=-Dfile.encoding=utf-8 wrapper.java.additional.#=-Dsun.jnu.encoding=utf-8Make sure to replace the # with the next available digit in the series of Java additionals. The numbers must be sequential for the argument to apply.
Add a new environment variable in the Windows system with the following name and value:
Environment variable name Environment variable value JAVA_TOOL_OPTIONS -Dfile.encoding=UTF8 -Dsun.jnu.encoding=UTF8
- Restart the agent and check that your system encoding changes to utf-8 from the agent's general configuration page.