Elastic Agent Cannot Checkout UTF-8 Filenames From Subversion

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

Symptoms

Your elastic image is unable to download certain files from your Subversion repository, and you see errors similar to this:

1 2 3 Command output: svn: Can't convert string from 'UTF-8' to native encoding: svn: components/file-N?\195?\181chstes.gif

Cause

The locale on the elastic image Operating System is not configured correctly.

Resolution

Try setting your locale to UTF8. For example in Linux, if you want to set the locale to German:

1 export LANG=de_DE.UTF-8

This needs to be done for the user that's starting the Bamboo Agent.

If you're using Maven, you may also need to set this property in your pom.xml:

1 2 3 <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties>
Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.