Configuring Log Encoding Settings

Print Friendly and PDF Follow

Product Ares
Version All
Ticket N/A
KB Permissions Public


As of Ares v5.0.9, logs for the following Ares components have been configured to use UTF-8 encoding by default to fix an issue where some characters, such as those with diacritics and non-Latin characters, did not display correctly:

  • Ares Client
  • Customization Manager
  • Staff Manager
  • System Manager
  • Web API
  • Web Service

This change will only apply automatically to new Ares installs (i.e., those installing Ares for the first time at version 5.0.9). If you are using a previous version of Ares or have updated to Ares v5.0.9 from a previous version of Ares, the encoding change must be made manually to the configuration file for each log following the instructions below.


To configure the log file for each component to use UTF-8 encoding, a new line must be added to each log's configuration file. The configuration file for each log is found where the relevant component for that log is installed (e.g., the configuration file for the Ares Client log will be located wherever the Ares Client is installed on the machine). The default location and name of each log configuration file are both noted in the table below. Please use the table to locate each configuration file and apply the encoding change manually using the following instructions: 

  1. Use the table below to locate and navigate to the Ares component log's configuration file
  2. Open the log configuration file in a text editing application such as Notepad++
  3. Add a line for <encoding value="utf-8" />  in the section of code nested under the <appender> element, for example:
    <?xml version="1.0" encoding="utf-8"?>
    <level value="INFO" />
    <appender-ref ref="RollingFile" />

    <appender name="RollingFile" type="log4net.Appender.RollingFileAppender">
    <file value="Logs\AresSystemManager.log" />
    <appendToFile value="true" />
    <maximumFileSize value="5MB" />
    <maxSizeRollBackups value="5" />
    <rollingStyle value="Size" />
    <staticLogFileName value="true" />
    <preserveLogFileNameExtension value="true" />
    <encoding value="utf-8" />

    <layout type="log4net.Layout.PatternLayout">
    <conversionPattern value="%date [%thread] %-5level %logger - %message%newline%exception"/>
  4. Save and close the log configuration file
  5. Repeat steps 1-4 until all log configuration files listed in the table have been modified

Log Configuration Files

Component Log Configuration File Name Default File Location
Ares Client AresClient.log.config

Located on the local machine:

  • Per-machine installation:
    C:\Program Files (x86)\Ares\Client\
  • Per-user installation:

Customization Manager


Located on the local machine:

  • Per-machine installation:
    C:\Program Files (x86)\Ares\CustomizationManager\
  • Per-user installation:

Staff Manager


Located on the local machine:

  • Per-machine installation:
    C:\Program Files (x86)\Ares\StaffManager\
  • Per-user installation:

System Manager


Located on the Ares Server:

  • C:\Ares\Admin\



Located on the Ares Server:

  • C:\Ares\Web\WebApi\

Web Service


Located on the Ares Server:

  • C:\Ares\Web\WebService\App_Data\


If this article didn’t resolve your issue, please contact Atlas Support for assistance:

Contact Support