---
name: "cdist-type__locale_system"
section: "7"
platform: "linux"
package: "cdist"
version: "7.0.0-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cdist-type__locale_system"
---

# cdist-type\_\_locale\_system(7)

Set system-wide locale

## NAME

cdist-type\_\_locale\_system - Set system-wide locale

## DESCRIPTION

This cdist type allows you to modify system-wide locale. The name of the locale category is given as the object id (usually you are probably interested in using LANG).

## OPTIONAL PARAMETERS

- **state**

  present or absent, defaults to present. If present, sets the locale category to the given value. If absent, removes the locale category from the system file.

- **value**

  The value for the locale category. Defaults to en\_US.UTF-8.

## EXAMPLES

```
# Set LANG to en_US.UTF-8
__locale_system LANG
# Same as above, but more explicit
__locale_system LANG --value en_US.UTF-8
# Set category LC_MESSAGES to de_CH.UTF-8
__locale_system LC_MESSAGES --value de_CH.UTF-8
# Remove setting for LC_ALL
__locale_system LC_ALL --state absent
```

## SEE ALSO

[**locale**(1)](/locale/1.md), [**localedef**(1)](/localedef/1.md), [**cdist-type\_\_locale**(7)](/cdist-type__locale/7.md)

## AUTHORS

```
Steven Armstrong <steven-cdist--@--armstrong.cc>
Carlos Ortigoza <carlos.ortigoza--@--ungleich.ch>
Nico Schottelius <nico.schottelius--@--ungleich.ch>
```

## COPYING

Copyright (C) 2016 Nico Schottelius. Free use of this software is granted under the terms of the GNU General Public License version 3 or later (GPLv3+).

## COPYRIGHT

ungleich GmbH 2021