Survey banner
The Dataiku Community is moving to a new home! We are temporary in read only mode: LEARN MORE

DSS installatino fails: ValueError: unknown locale: UTF-8

DSS installatino fails: ValueError: unknown locale: UTF-8

Got this when trying to install DSS:

Traceback (most recent call last):
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/scripts/dkuinstall/", line 4, in <module>
import base
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/scripts/dkuinstall/", line 8, in <module>
import migration_base
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/scripts/dkuinstall/", line 175, in <module>
import steps
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/scripts/dkuinstall/", line 8, in <module>
import pandas as pd
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/pandas/", line 39, in <module>
from pandas.core.api import *
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/pandas/core/", line 10, in <module>
from pandas.core.groupby import Grouper
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/pandas/core/", line 18, in <module>
from pandas.core.frame import DataFrame
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/pandas/core/", line 39, in <module>
from pandas.core.series import Series
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/pandas/core/", line 2944, in <module>
import as _gfx # noqa
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/pandas/tools/", line 27, in <module>
import pandas.tseries.converter as conv
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/pandas/tseries/", line 7, in <module>
import matplotlib.units as units
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/matplotlib/", line 1131, in <module>
rcParams = rc_params()
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/matplotlib/", line 975, in rc_params
return rc_params_from_file(fname, fail_on_error)
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/matplotlib/", line 1100, in rc_params_from_file
config_from_file = _rc_params_in_file(fname, fail_on_error)
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/matplotlib/", line 1018, in _rc_params_in_file
with _open_file_or_url(fname) as fd:
File "/usr/lib64/python2.7/", line 17, in __enter__
File "/mnt/resource/installers/dataiku/dataiku-dss-3.1.0/python.packages/matplotlib/", line 1000, in _open_file_or_url
encoding = locale.getdefaultlocale()[1]
File "/mnt/resource/data/dss-data-dir/pyenv/lib64/python2.7/", line 511, in getdefaultlocale
return _parse_localename(localename)
File "/mnt/resource/data/dss-data-dir/pyenv/lib64/python2.7/", line 443, in _parse_localename
raise ValueError, 'unknown locale: %s' % localename
ValueError: unknown locale: UTF-8

How can I fix this ?

0 Kudos
1 Reply


This issue happens when you try to install on a Linux server after doing a SSH connection from a Mac. It is caused by an invalid locale (internationalization) setting on your Mac.

A little known property of the ssh client is that it is able to forward your locale settings so that after remotely connecting, you find yourself with a properly localized machine. Your mac has "UTF-8" as setting for some parts of the locale, which is not valid for your Linux box.

You probably receive a warning when opening the SSH connection like:

-bash: warning: setlocale: LC_CTYPE: cannot change locale (UTF-8): No such file or directory

You can fix this on your Mac side by adding this to your .profile (or .bashrc) file:

export LANG=en_US.UTF-8

export LC_ALL=en_US.UTF-8

You can also add this on your .profile (or .bashrc) file on the Linux box itself:

export LANG=en_US.UTF-8

export LC_ALL=en_US.UTF-8

After logging out and logging back in, run "locale" on the Linux box, which should not display any error anymore. DSS install will now work properly.


0 Kudos


Labels (3)
A banner prompting to get Dataiku