From: marc tobias <mtmail@gmx.net>
Date: Mon, 29 Jul 2024 16:26:11 +0000 (+0200)
Subject: Admin FAQ entry for UnicodeEncodeError
X-Git-Tag: deploy~4^2~6^2
X-Git-Url: https://git.openstreetmap.org./nominatim.git/commitdiff_plain/04a3f39371099bbe25536c914809595378aa8533

Admin FAQ entry for UnicodeEncodeError
---

diff --git a/docs/admin/Faq.md b/docs/admin/Faq.md
index 7730c6c5..efcd5741 100644
--- a/docs/admin/Faq.md
+++ b/docs/admin/Faq.md
@@ -142,6 +142,25 @@ Make sure you have the PostgreSQL extensions "hstore" and "postgis" installed.
 See the installation instructions for a full list of required packages.
 
 
+### UnicodeEncodeError: 'ascii' codec can't encode character
+
+Make sure that the operating system's locale is UTF-8. With some prebuilt
+images (e.g. LXC containers from Proxmox, see
+[discussion](https://github.com/osm-search/Nominatim/discussions/2343)) or
+images that optimize for size it might be missing.
+
+On Ubuntu you can check the locale is installed:
+
+```
+   grep UTF-8 /etc/default/locale
+```
+
+And install it using
+
+```
+   dpkg-reconfigure locales
+```
+
 ### I forgot to delete the flatnodes file before starting an import.
 
 That's fine. For each import the flatnodes file get overwritten.