This documentation relates to an early version of Confluence.
View this page in the current documentation or visit the current documentation home.

Configuring Tomcat's URI encoding

Added by Matt Ryall (Atlassian), last edited by Matt Ryall (Atlassian) on May 25, 2006
All Versions
Click for all versions
Confluence 2.5.4 to 2.5.8 Documentation

Index

By default, Tomcat uses ISO-8859-1 character encoding when decoding URLs received from a browser. This can cause problems when Confluence's encoding is UTF-8, and you are using international characters in attachment or page names.

  1. Edit conf/server.xml and find the line where the Coyote HTTP Connector is defined. It will look something like this, possibly with more parameters: 
    <Connector port="8080"/>
  2. Add a URIEncoding="UTF-8" property to the connector: 
    <Connector port="8080" URIEncoding="UTF-8"/>
  3. Restart Tomcat

If you are using mod_jk

You should apply the same URIEncoding parameter as above to the AJP connector if you are using mod_jk, and add the following option to your Apache mod_jk configuration:

<Connector port="8009" protocol="AJP/1.3" URIEncoding="UTF-8"/>

JkOptions +ForwardURICompatUnparsed

More information using Apache with Tomcat

For comprehensive examples of how to use Tomcat and Apache with Confluence, see Running Confluence behind Apache.

Labels

apache apache Delete
tomcat tomcat Delete
uri uri Delete
url url Delete
encoding encoding Delete
unicode unicode Delete
international international Delete
i18n i18n Delete
connector connector Delete
mod_jk mod_jk Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.