How to configure UTF-8 encoding on Windows remote agents
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. 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
1. Shutdown the remote agent
2. Edit $BAMBOO_AGENT_HOME/conf/wrapper.conf
3. Add the below lines:
wrapper.conf
wrapper.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.
4. 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 |
5. Restart the agent and check that your system encoding changes to utf-8 from the agent's general configuration page.
Was this helpful?