Tableau Server Initialize-Tsm Fails With Locale Error

Published: 02 Jul 2020
Last Modified Date: 08 Jul 2022


After "yum install" of Tableau Server, the next step "initialize-tsm" fails with locale error:

$ sudo /opt/tableau/tableau_server/packages/script<version>/initialize-tsm --accepteula -a user1 -f

Locale 'en_IN' is not using UTF-8 encoding. UTF-8 is required.
Example UTF-8 locales are en_US.UTF-8 or ja_JP.UTF-8 etc. Run 'locale -a' to see
a list of supported locales on your system.


  • Tableau Server
  • CentOS 7


Check the system locale of the Linux to ensure it falls into the 11 supported locales, refer to Additional Information.

To check system locale, run the commands below:

$  cat /etc/locale.conf
$  localectl

To set the locale correctly, run the commands below:

$ sudo yum update systemd      (optional, run only if the systemd is in old version that causes the following command not updating)
$ sudo localectl set-locale LANG=en_US.UTF-8

In some cases, setting the above still may not resolve the issue. In that case, it may be the shell of the Linux prompt uses a specified locale. Run the commands below to set the environment variable for the shell:

$ localedef -c -f UTF-8 -i en_US en_US.UTF-8
$ export LC_ALL=en_US.UTF-8

After this, re-run the initialize-tsm command



Tableau Server runs on a system using one of the following locales:

de_DE, en_GB, en_US, es_ES, fr_FR, it_IT, ja_JP, ko_KR, pt_BR, zh_CN, or zh_TW.

Any other locale will generate the error.

Did this article resolve the issue?