libre/dev-libre-is
libre/dev-libre-is
4
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity

nominatim notes

Browse source
This commit is contained in:
Jeff Moe 2024-09-14 11:04:23 -06:00
parent 5ab9f9c6ff
commit a4e346fc2d
2 changed files with 93 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

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

@ -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 ""

49
docs/_source/maps-libre-is.rst
View file

@ -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