Compatibility :3.5.35
Editions :Professional EditionStandard EditionCommunity Edition (Not Supported)
Platforms :WindowsMac OSXLinuxIBM AIXFreeBSDHP-UXSolarisIBM z/OSIBM z/Linux

This property is used to set the default encoding of the JVM when it should be different than the encoding used by the Wrapper. Its usage requires that the JVM supports the sun.stdout.encoding and sun.stderr.encoding system properties (i.e. Java 8 and above for the Oracle and OpenJDK implementations).

The value should be one of the encodings supported by the JVM, such as those listed on the Oracle website. The default value is DEFAULT which means that the value will be resolved using the value of wrapper.lang.<platform>.encoding. However, since the latters are using the OS syntax, the Wrapper will convert the value into the JVM syntax.

Example: (set the JVM default encoding to 'EUC-JP', while the Wrapper uses UTF-8)


Usage of this property (any value other than 'DEFAULT') requires that there is no reference of 'file.encoding', 'sun.stdout.encoding' or 'sun.stderr.encoding' in the arguments passed to the JVM, otherwise the Wrapper will stop!

This property is not reloaded when the JVM restarts and wrapper.restart.reload_configuration is set to TRUE. However, if any of the above system properties were added in the JVM arguments while this property being set, the Wrapper will stop.


If the Java version is less than 8 (or if the JVM doesn't support the sun properties mentioned above), the property has to be set to DEFAULT, otherwise the Wrapper will consider it as a misconfiguration and stop.

Whenever the JVM and the Wrapper can use the same encoding, wrapper.lang.<platform>.encoding is preferred and allows to set both encodings at once.