SmarterMail Doesn't Run After Changing Windows Locale

This article applies to recent versions of SmarterMail. View articles for SmarterMail 16.x and earlier.

Modifying the server's Windows locale is not recommended nor supported as it can cause corrupted GRP files and prevent SmarterMail from running. This can happen when the changed locale causes the default CodePage to change. An example where this would occur is changing from an English locale to Japanese. Changing the default CodePage could cause corrupted files with unpredictable consequences. It is recommended to change the Windows locale back to the value it was set to on the initial SmarterMail install.

If the Windows locale must be changed, SmarterMail can be set to accept this change by doing the following steps:

  1. Stop the SmarterMail service (mailService). 
  2. Open the Settings.json file with a text editor. The default install path for this file is C:\Program Files (x86)\SmarterTools\SmarterMail\Service\Settings\. ( Linux: /etc/smartermail/settings.json )
  3. Remove the following lines:
    "system_encoding": { "CodePage": 1252 },
            
  4. Restart the SmarterMail service.
Please note that any corruption or issues caused by the locale change cannot be supported by the Support Department.

Learn more about SmarterMail's enterprise email features and benefits.

Feedback

We are encountering this error after switching from Windows to Linux so if applying this fix is not recommended what is the "supported" method of fixing it?
Mark Donne (2/4/2026 at 5:52 AM)
Hi, Mark. I've edited this from my first response.

When migrating from Windows to Linux, this should not be an issue. If the Windows locale was changed prior to the migration, that should be fixed first, then migrate to Linux.

Locale issues shouldn't be problematic post migration as Linux doesn't use Windows CodePages, which is what this KB references. The migration itself, when done properly between the correct directory paths, should be seamless regardless of what locale the Linux box is using.

Derek Curtis (2/4/2026 at 7:37 AM)