Using non-ASCII characters on a production deployment or running the Build Verification Test (BVT) in development require that your server supports UTF-8 URI encoding. If running Tomcat 7.0.x, you need to modify your server configuration in $TOMCAT_HOME/conf/server.xml to specify this encoding. Add the following attributes to your Connector element:


For example, the modified Tomcat non-SSL HTTP/1.1 connector might appear as follows:

<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
<Connector port="8080" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"
useBodyEncodingForURI="true" URIEncoding="UTF-8"/>

For more information on configuring Tomcat HTTP connectors, see the Tomcat documentation at

URIEncoding defaults to UTF-8 starting with Tomcat 8.0.x, so this step is not required for Tomcat 8.0.x or 8.5.x.

Related Topics


expand all collapse all