Locales - Revision history

Pigs: fix broken supportedLocales to extraLocales

2025-10-30T18:09:39Z

fix broken supportedLocales to extraLocales

← Older revision		Revision as of 18:09, 30 October 2025
Line 28:		Line 28:
	{{nixos:option\|i18n.defaultLocale}} will set the language and the character set systemwide to the desired value. Specifically, defaultLocale will define the <code>LANG</code> environment variable.		{{nixos:option\|i18n.defaultLocale}} will set the language and the character set systemwide to the desired value. Specifically, defaultLocale will define the <code>LANG</code> environment variable.

	In addition, with {{nixos:option\|i18n.~~supportedLocales~~}}, the system will also support Venezuelan Spanish. The value <code>"all"</code> means that all locales supported by Glibc will be installed. A full list of supported locales can be found at https://sourceware.org/git/?p=glibc.git;a=blob;f=localedata/SUPPORTED.		In addition, with {{nixos:option\|i18n.extraLocales}}, the system will also support Venezuelan Spanish. The value <code>"all"</code> means that all locales supported by Glibc will be installed. A full list of supported locales can be found at https://sourceware.org/git/?p=glibc.git;a=blob;f=localedata/SUPPORTED.

	And in the {{nixos:option\|i18n.extraLocaleSettings}}, it is possible to set the LC locales individually. This does allow fine-grained adjustments of the used locales. In the above example a mix of American English and Venezuelan Spanish is used. It is also possible to find these settings at [https://search.nixos.org/options NixOS options]. Just search for i18 locale.		And in the {{nixos:option\|i18n.extraLocaleSettings}}, it is possible to set the LC locales individually. This does allow fine-grained adjustments of the used locales. In the above example a mix of American English and Venezuelan Spanish is used. It is also possible to find these settings at [https://search.nixos.org/options NixOS options]. Just search for i18 locale.

	{{note\|The setting <code>i18n.~~supportedLocales~~</code> requires a different format to <code>i18n.extraLocaleSettings</code> with the added <code>/UTF-8</code>. Otherwise, your locale settings will likely not work.}}		{{note\|The setting <code>i18n.extraLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code> with the added <code>/UTF-8</code>. Otherwise, your locale settings will likely not work.}}

	== Troubleshooting when using nix on non-NixOS linux distributions ==		== Troubleshooting when using nix on non-NixOS linux distributions ==

Nyadiia: Change "i18n.supportedLocales" to "i18n.extraLocales" to match other documentation

2025-08-28T16:08:23Z

Change "i18n.supportedLocales" to "i18n.extraLocales" to match other documentation

← Older revision		Revision as of 16:08, 28 August 2025
Line 6:		Line 6:

	# Optionally (BEWARE: requires a different format with the added /UTF-8)		# Optionally (BEWARE: requires a different format with the added /UTF-8)
	i18n.~~supportedLocales~~ = [~~"en_US.UTF-8/UTF-8"~~ "es_VE.UTF-8/UTF-8"];		i18n.extraLocales = ["es_VE.UTF-8/UTF-8"];

	# Optionally		# Optionally

Pigs: Add category, fix formatting

2025-05-18T16:28:35Z

Add category, fix formatting

← Older revision		Revision as of 16:28, 18 May 2025
Line 1:		Line 1:
			NixOS allows to set the default [https://en.wikipedia.org/wiki/Locale_(computer_software) locale] as well as individual locales in the system configuration file:

			{{file\|/etc/nixos/configuration.nix\|nix\|<nowiki>
			# Mandatory
			i18n.defaultLocale = "en_US.UTF-8";

	~~NixOS allows to set~~ the ~~default locale as well as individual locales in the configuration file:<syntaxhighlight lang~~="~~bash~~">		# Optionally (BEWARE: requires a different format with the added /UTF-8)
	~~configuration~~.~~nix~~		i18n.supportedLocales = ["en_US.UTF-8/UTF-8" "es_VE.UTF-8/UTF-8"];
	~~{...}~~

	~~# Mandatory~~		# Optionally
	~~i18n.defaultLocale = "en_US.UTF-8";~~		i18n.extraLocaleSettings = {

	~~# Optionally (BEWARE: requires a different format with the added /UTF-8)~~
	~~i18n.supportedLocales = ["en_US.UTF-8/UTF-8" "es_VE.UTF-8/UTF-8"];~~

	# Optionally
	i18n.extraLocaleSettings = {
	# LC_ALL = "en_US.UTF-8"; # This overrides all other LC_* settings.		# LC_ALL = "en_US.UTF-8"; # This overrides all other LC_* settings.
	LC_CTYPE = "en_US.UTF8";		LC_CTYPE = "en_US.UTF8";
Line 26:		Line 23:
	LC_COLLATE = "es_VE.UTF-8";		LC_COLLATE = "es_VE.UTF-8";
	};		};
	</~~syntaxhighlight~~>~~'''~~defaultLocale~~'''~~ will set the language and the character set systemwide to the desired value. Specifically, defaultLocale will define the <code>LANG</code> environment variable.		</nowiki>
			}}

			{{nixos:option\|i18n.defaultLocale}} will set the language and the character set systemwide to the desired value. Specifically, defaultLocale will define the <code>LANG</code> environment variable.

	In addition, with ~~'''~~supportedLocales~~'''~~, the system will also support Venezuelan Spanish. The value <code>"all"</code> means that all locales supported by Glibc will be installed. A full list of supported locales can be found at https://sourceware.org/git/?p=glibc.git;a=blob;f=localedata/SUPPORTED.		In addition, with {{nixos:option\|i18n.supportedLocales}}, the system will also support Venezuelan Spanish. The value <code>"all"</code> means that all locales supported by Glibc will be installed. A full list of supported locales can be found at https://sourceware.org/git/?p=glibc.git;a=blob;f=localedata/SUPPORTED.

	And in the ~~'''~~extraLocaleSettings~~'''~~, it is possible to set the LC locales individually. This does allow fine-grained adjustments of the used locales. In the above example a mix of American English and Venezuelan Spanish is used. It is also possible to find these settings at [https://search.nixos.org/options NixOS options]. Just search for i18 locale.		And in the {{nixos:option\|i18n.extraLocaleSettings}}, it is possible to set the LC locales individually. This does allow fine-grained adjustments of the used locales. In the above example a mix of American English and Venezuelan Spanish is used. It is also possible to find these settings at [https://search.nixos.org/options NixOS options]. Just search for i18 locale.

	~~'''BEWARE:'''~~ The setting <code>i18n.supportedLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code> with the added <code>/UTF-8</code>. Otherwise, your locale settings will likely not work.		{{note\|The setting <code>i18n.supportedLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code> with the added <code>/UTF-8</code>. Otherwise, your locale settings will likely not work.}}

	== Troubleshooting when using nix on non-NixOS linux distributions ==		== Troubleshooting when using nix on non-NixOS linux distributions ==
Line 67:		Line 67:
	}		}
	</syntaxhighlight>		</syntaxhighlight>

			[[Category:Configuration]]

Exuberant7857: `supportedLocales` is supposed to be declared within a single i18n layer, as can be seen here:

2025-04-09T15:08:58Z

`supportedLocales` is supposed to be declared within a single i18n layer, as can be seen here:

← Older revision		Revision as of 15:08, 9 April 2025
Line 9:		Line 9:

	# Optionally (BEWARE: requires a different format with the added /UTF-8)		# Optionally (BEWARE: requires a different format with the added /UTF-8)
	~~i18n.~~i18n.supportedLocales = ["en_US.UTF-8/UTF-8" "es_VE.UTF-8/UTF-8"];		i18n.supportedLocales = ["en_US.UTF-8/UTF-8" "es_VE.UTF-8/UTF-8"];

	# Optionally		# Optionally

Turbotimon: Improve extraLocaleSettings code

2025-03-25T08:29:19Z

Improve extraLocaleSettings code

← Older revision		Revision as of 08:29, 25 March 2025
Line 13:		Line 13:
	# Optionally		# Optionally
	i18n.extraLocaleSettings = {		i18n.extraLocaleSettings = {
	LC_ALL = "en_US.UTF-8";		# LC_ALL = "en_US.UTF-8"; # This overrides all other LC_* settings.
	LC_CTYPE = "en_US.UTF8";		LC_CTYPE = "en_US.UTF8";
	LC_ADDRESS = "es_VE.UTF-8";		LC_ADDRESS = "es_VE.UTF-8";
	~~LC_IDENTIFICATION = "es_VE.UTF-8";~~
	LC_MEASUREMENT = "es_VE.UTF-8";		LC_MEASUREMENT = "es_VE.UTF-8";
	LC_MESSAGES = "en_US.UTF-8";		LC_MESSAGES = "en_US.UTF-8";

Turbotimon: add more contect for supportedLocales

2025-03-21T12:47:37Z

add more contect for supportedLocales

← Older revision		Revision as of 12:47, 21 March 2025
Line 27:		Line 27:
	LC_COLLATE = "es_VE.UTF-8";		LC_COLLATE = "es_VE.UTF-8";
	};		};
	</syntaxhighlight>'''defaultLocale''' will set the ~~locale~~ systemwide to the desired value. In addition, with '''supportedLocales''', the system will also support Venezuelan Spanish. And in the '''extraLocaleSettings''', it is possible to set the LC locales individually. This does allow fine-grained adjustments of the used locales. In the above example a mix of American English and Venezuelan Spanish is used. It is also possible to find these settings at [https://search.nixos.org/options NixOS options]. Just search for i18 locale.		</syntaxhighlight>'''defaultLocale''' will set the language and the character set systemwide to the desired value. Specifically, defaultLocale will define the <code>LANG</code> environment variable.

			In addition, with '''supportedLocales''', the system will also support Venezuelan Spanish. The value <code>"all"</code> means that all locales supported by Glibc will be installed. A full list of supported locales can be found at https://sourceware.org/git/?p=glibc.git;a=blob;f=localedata/SUPPORTED.

			And in the '''extraLocaleSettings''', it is possible to set the LC locales individually. This does allow fine-grained adjustments of the used locales. In the above example a mix of American English and Venezuelan Spanish is used. It is also possible to find these settings at [https://search.nixos.org/options NixOS options]. Just search for i18 locale.

	'''BEWARE:''' The setting <code>i18n.supportedLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code> with the added <code>/UTF-8</code>. Otherwise, your locale settings will likely not work.		'''BEWARE:''' The setting <code>i18n.supportedLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code> with the added <code>/UTF-8</code>. Otherwise, your locale settings will likely not work.

Turbotimon: Partially taken from nixos.wiki/wiki/Locales to give a full picture. Adjusted/shortened some part to fit and fixed some spelling errors

2025-03-21T12:35:02Z

Partially taken from nixos.wiki/wiki/Locales to give a full picture. Adjusted/shortened some part to fit and fixed some spelling errors

← Older revision		Revision as of 12:35, 21 March 2025
Line 1:		Line 1:
	~~== Notes when setting supportedLocales and extraLocaleSettings ==~~
	~~Beaware when setting up your locale variables. The setting <code>i18n.supportedLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code>.~~

	~~The setting <code>i18n.supportedLocales</code> requries the requires the language string '''with''' the added <code>/UTF-8</code>~~

	<syntaxhighlight lang="bash">		NixOS allows to set the default locale as well as individual locales in the configuration file:<syntaxhighlight lang="bash">
	~~"en_US~~.~~UTF-8/UTF-8"~~		configuration.nix
	~~"nl_NL~~.~~UTF-8/UTF-8"~~		{...}
	~~</syntaxhighlight>~~

	~~The setting <code>~~i18n.~~extraLocaleSettings</code>, however, requires the language string '''without''' any suffix~~.		# Mandatory
			i18n.defaultLocale = "en_US.UTF-8";

	~~<syntaxhighlight lang~~="~~bash~~">		# Optionally (BEWARE: requires a different format with the added /UTF-8)
	LC_MESSAGES = "en_US.UTF-8"		i18n.i18n.supportedLocales = ["en_US.UTF-8/UTF-8" "es_VE.UTF-8/UTF-8"];
	LC_TIME = "~~de_DE~~.UTF-8"
	</syntaxhighlight>Otherwise, your locale settings will likely not work.		# Optionally
			i18n.extraLocaleSettings = {
			LC_ALL = "en_US.UTF-8";
			LC_CTYPE = "en_US.UTF8";
			LC_ADDRESS = "es_VE.UTF-8";
			LC_IDENTIFICATION = "es_VE.UTF-8";
			LC_MEASUREMENT = "es_VE.UTF-8";
			LC_MESSAGES = "en_US.UTF-8";
			LC_MONETARY = "es_VE.UTF-8";
			LC_NAME = "es_VE.UTF-8";
			LC_NUMERIC = "en_US.UTF-8";
			LC_PAPER = "es_VE.UTF-8";
			LC_TELEPHONE = "es_VE.UTF-8";
			LC_TIME = "es_VE.UTF-8";
			LC_COLLATE = "es_VE.UTF-8";
			};
			</syntaxhighlight>'''defaultLocale''' will set the locale systemwide to the desired value. In addition, with '''supportedLocales''', the system will also support Venezuelan Spanish. And in the '''extraLocaleSettings''', it is possible to set the LC locales individually. This does allow fine-grained adjustments of the used locales. In the above example a mix of American English and Venezuelan Spanish is used. It is also possible to find these settings at [https://search.nixos.org/options NixOS options]. Just search for i18 locale.

			'''BEWARE:''' The setting <code>i18n.supportedLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code> with the added <code>/UTF-8</code>. Otherwise, your locale settings will likely not work.

	== Troubleshooting when using nix on non-NixOS linux distributions ==		== Troubleshooting when using nix on non-NixOS linux distributions ==

Jooooscha: Add a note about the syntactic differences in setting the supported locales and the extra locale settings

2025-01-21T22:55:34Z

Add a note about the syntactic differences in setting the supported locales and the extra locale settings

← Older revision		Revision as of 22:55, 21 January 2025
Line 1:		Line 1:
			== Notes when setting supportedLocales and extraLocaleSettings ==
			Beaware when setting up your locale variables. The setting <code>i18n.supportedLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code>.

			The setting <code>i18n.supportedLocales</code> requries the requires the language string '''with''' the added <code>/UTF-8</code>

			<syntaxhighlight lang="bash">
			"en_US.UTF-8/UTF-8"
			"nl_NL.UTF-8/UTF-8"
			</syntaxhighlight>

			The setting <code>i18n.extraLocaleSettings</code>, however, requires the language string '''without''' any suffix.

			<syntaxhighlight lang="bash">
			LC_MESSAGES = "en_US.UTF-8"
			LC_TIME = "de_DE.UTF-8"
			</syntaxhighlight>Otherwise, your locale settings will likely not work.

	== Troubleshooting when using nix on non-NixOS linux distributions ==		== Troubleshooting when using nix on non-NixOS linux distributions ==

Roland: Document Locales with nix profile

2024-09-30T19:10:28Z

Document Locales with nix profile

← Older revision		Revision as of 19:10, 30 September 2024
Line 9:		Line 9:
	And if that file from the local system is somehow broken:		And if that file from the local system is somehow broken:

	<syntaxhighlight lang=bash>		<syntaxhighlight lang="bash">
	# May require a one-time installation with: nix-env -iA nixpkgs.glibcLocales		# May require a one-time installation with:
			nix profile install nixpkgs#glibcLocales
			# Using nix profile
			export LOCALE_ARCHIVE="$(nix profile list --json \| jq '.elements[] \| select(.attrPath? and (.attrPath \| type == "string") and (.attrPath \| endswith("glibcLocales"))) \| .storePaths[0]')/lib/locale/locale-archive"

			# Legacy usage with `nix-env`: May require a one-time installation with: nix-env -iA nixpkgs.glibcLocales
	export LOCALE_ARCHIVE="$(nix-env --installed --no-name --out-path --query glibc-locales)/lib/locale/locale-archive"		export LOCALE_ARCHIVE="$(nix-env --installed --no-name --out-path --query glibc-locales)/lib/locale/locale-archive"



	</syntaxhighlight>		</syntaxhighlight>

imported>Pmorch at 13:47, 27 March 2024

2024-03-27T13:47:16Z

← Older revision		Revision as of 13:47, 27 March 2024
Line 10:		Line 10:

	<syntaxhighlight lang=bash>		<syntaxhighlight lang=bash>
			# May require a one-time installation with: nix-env -iA nixpkgs.glibcLocales
	export LOCALE_ARCHIVE="$(nix-env --installed --no-name --out-path --query glibc-locales)/lib/locale/locale-archive"		export LOCALE_ARCHIVE="$(nix-env --installed --no-name --out-path --query glibc-locales)/lib/locale/locale-archive"
	</syntaxhighlight>		</syntaxhighlight>

← Older revision		Revision as of 18:09, 30 October 2025
Line 28:		Line 28:
	{{nixos:option\|i18n.defaultLocale}} will set the language and the character set systemwide to the desired value. Specifically, defaultLocale will define the <code>LANG</code> environment variable.		{{nixos:option\|i18n.defaultLocale}} will set the language and the character set systemwide to the desired value. Specifically, defaultLocale will define the <code>LANG</code> environment variable.

	In addition, with {{nixos:option\|i18n.~~supportedLocales~~}}, the system will also support Venezuelan Spanish. The value <code>"all"</code> means that all locales supported by Glibc will be installed. A full list of supported locales can be found at https://sourceware.org/git/?p=glibc.git;a=blob;f=localedata/SUPPORTED.		In addition, with {{nixos:option\|i18n.extraLocales}}, the system will also support Venezuelan Spanish. The value <code>"all"</code> means that all locales supported by Glibc will be installed. A full list of supported locales can be found at https://sourceware.org/git/?p=glibc.git;a=blob;f=localedata/SUPPORTED.

	And in the {{nixos:option\|i18n.extraLocaleSettings}}, it is possible to set the LC locales individually. This does allow fine-grained adjustments of the used locales. In the above example a mix of American English and Venezuelan Spanish is used. It is also possible to find these settings at [https://search.nixos.org/options NixOS options]. Just search for i18 locale.		And in the {{nixos:option\|i18n.extraLocaleSettings}}, it is possible to set the LC locales individually. This does allow fine-grained adjustments of the used locales. In the above example a mix of American English and Venezuelan Spanish is used. It is also possible to find these settings at [https://search.nixos.org/options NixOS options]. Just search for i18 locale.

	{{note\|The setting <code>i18n.~~supportedLocales~~</code> requires a different format to <code>i18n.extraLocaleSettings</code> with the added <code>/UTF-8</code>. Otherwise, your locale settings will likely not work.}}		{{note\|The setting <code>i18n.extraLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code> with the added <code>/UTF-8</code>. Otherwise, your locale settings will likely not work.}}

	== Troubleshooting when using nix on non-NixOS linux distributions ==		== Troubleshooting when using nix on non-NixOS linux distributions ==