nominatim notes

docs/_source/locale/en/LC_MESSAGES/maps-libre-is.po

@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Libre Developers Documentation 0\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-09-14 10:47-0600\n"
+"POT-Creation-Date: 2024-09-14 11:04-0600\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language: en\n"
@@ -36,70 +36,98 @@ msgstr ""
 msgid "Using Debian stable (12/bookworm)."
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:13
+#: ../../../_source/maps-libre-is.rst:11
+msgid "Install dependenices:"
+msgstr ""
+
+#: ../../../_source/maps-libre-is.rst:22
 msgid "Firewall"
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:14
+#: ../../../_source/maps-libre-is.rst:23
 msgid "Open ports 80 and 443 for web."
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:17
+#: ../../../_source/maps-libre-is.rst:26
 msgid "Apache"
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:18
+#: ../../../_source/maps-libre-is.rst:27
 msgid "Install and set up Apache."
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:27
+#: ../../../_source/maps-libre-is.rst:35
 msgid ""
 "Add new apache configs to /etc/apache2/sites-available/maps-libre-is.conf:"
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:71
+#: ../../../_source/maps-libre-is.rst:79
 msgid "Enable new configuration:"
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:82
+#: ../../../_source/maps-libre-is.rst:91
 msgid "Nominatim"
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:83
+#: ../../../_source/maps-libre-is.rst:92
 msgid ""
 "\"Nominatim uses OpenStreetMap data to find locations on Earth by name and "
 "address (geocoding). It can also do the reverse, find an address for any "
 "location on the planet.\""
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:87
+#: ../../../_source/maps-libre-is.rst:96
 msgid "`<https://nominatim.org/>`_"
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:89
+#: ../../../_source/maps-libre-is.rst:98
 msgid "`<https://github.com/osm-search/Nominatim>`_"
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:91
+#: ../../../_source/maps-libre-is.rst:100
 msgid "`<https://nominatim.org/release-docs/latest/admin/Installation/>`_"
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:93
+#: ../../../_source/maps-libre-is.rst:102
 msgid "The full installation is quite demanding:"
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:95
+#: ../../../_source/maps-libre-is.rst:104
 msgid "2GB RAM minimum."
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:97
+#: ../../../_source/maps-libre-is.rst:106
 msgid "Full planet import requires 128GB of RAM or more."
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:99
+#: ../../../_source/maps-libre-is.rst:108
 msgid "Full planet needs at least 1TB of fast disk."
 msgstr ""
 
-#: ../../../_source/maps-libre-is.rst:101
+#: ../../../_source/maps-libre-is.rst:110
 msgid "Full import of planet takes 2.5 days on NVMe, 4-5 days on SSD."
 msgstr ""
+
+#: ../../../_source/maps-libre-is.rst:112
+msgid "With the large disk, create a mount in /srv."
+msgstr ""
+
+#: ../../../_source/maps-libre-is.rst:114
+msgid "Set up Nominatim user and switch to it."
+msgstr ""
+
+#: ../../../_source/maps-libre-is.rst:126
+msgid "Postgres"
+msgstr ""
+
+#: ../../../_source/maps-libre-is.rst:127
+msgid "Postgres is needed by Nominatim."
+msgstr ""
+
+#: ../../../_source/maps-libre-is.rst:139
+msgid "Nominatim Install"
+msgstr ""
+
+#: ../../../_source/maps-libre-is.rst:140
+msgid "As user nominatim."
+msgstr ""

docs/_source/maps-libre-is.rst

@@ -8,6 +8,15 @@ Debian
 ======
 Using Debian stable (12/bookworm).
 
+Install dependenices:
+
+.. code-block:: sh
+
+  sudo apt install apache2 python3-certbot-apache \
+  osm2pgsql postgresql-postgis postgresql-postgis-scripts \
+  pkg-config libicu-dev virtualenv python3-pip \
+  build-essential python3-dev
+
 
 Firewall
 ========
@@ -19,7 +28,6 @@ Install and set up Apache.
 
 .. code-block:: sh
 
-  sudo apt install apache2 python3-certbot-apache
   certbot -d maps.libre.is -d map.libre.is
   # remove old apache configs:
   rm /etc/apache2/sites-enabled/000-default*
@@ -78,6 +86,7 @@ Enable new configuration:
   sudo systemctl restart apache2  
 
 
+
 Nominatim
 =========
 "Nominatim uses OpenStreetMap data to find locations on Earth by name and
@@ -100,3 +109,41 @@ The full installation is quite demanding:
 
 * Full import of planet takes 2.5 days on NVMe, 4-5 days on SSD.
 
+With the large disk, create a mount in /srv.
+
+Set up Nominatim user and switch to it.
+
+.. code-block:: sh
+
+  sudo useradd -d /srv/nominatim -s /bin/bash -m nominatim
+  sudo -u nominatim bash
+  export USERNAME=nominatim
+  export USERHOME=/srv/nominatim
+  chmod a+x $USERHOME
+
+
+Postgres
+========
+Postgres is needed by Nominatim.
+
+.. code-block:: sh
+
+  export USERNAME=nominatim
+  export USERHOME=/srv/nominatim
+  sudo systemctl restart postgresql
+  sudo -u postgres createuser -s $USERNAME
+  sudo -u postgres createuser www-data
+
+
+Nominatim Install
+=================
+As user nominatim.
+
+.. code-block::
+
+  sudo -u nominatim bash
+  export USERNAME=nominatim
+  export USERHOME=/srv/nominatim
+  virtualenv $USERHOME/nominatim-venv
+  $USERHOME/nominatim-venv/bin/pip install nominatim-db
+  . $USERHOME/nominatim-venv/bin/activate