smithmicro/n7m-app repository overview

⁠n7m

Minimalistic Docker images for Nominatim

⁠About

n7m is a Numeronym⁠ for Nominatim⁠.

n7m is Nominatim packaged in Docker images with separation of responsibilities between housing the web server, ui, applicaiton server, setup processes and PostgreSQL.

⁠Overview

This set of Docker images seperates responsbility into 5 areas:

• n7m-app - The main Nomainatim service running uvicorn connecting to n7m-gis
  • feed - Uses the n7m-app image to set up the n7m-gis database. Can also be used for updates and downloading files.
• n7m-gis - Postgis database
• n7m-ui - Test web user interface
• n7m-web - nginx web sever that hosts:
  • n7m-app @ path: /api/v4/
  • n7m-ui @ path: /

⁠Architecture

       |
       v 8080
+--------------+      +--------------+
|              |      |              |
|   n7m-web    |----->|    n7m-ui    |
|              |  80  |              |
+--------------+      +--------------+
|    nginx     |      |    nginx     |
+--------------+      +--------------+
       |
       v 8000
+--------------+      +--------------+
|              |      |              |
|   n7m-app    |      |     feed     |
|              |      |              |
+--------------+      +--------------+
| ubuntu:jammy |      |   n7m-app    |
+--------------+      +--------------+
               |              |     |
               v      5432    v     v
/--------\   +-----------------+   /--------\
| volume |<--|                 |   | volume |
| pgdata |   |     n7m-gis     |   |  data  |
\--------/   +                 +   \--------/
             |-----------------+
             | postgis/postgis |
             +-----------------+

⁠To Use

1. Build all the images:
   • docker-compose build
2. Download Wikimedia data and country grids (optional):
   • docker-compose run feed download --wiki --grid
3. Download OSM Data. We recommend openmaptiles-tools⁠. For Monaco:
   • docker run -v <path to working dir>/data:/tileset openmaptiles/openmaptiles-tools download-osm monaco
4. Edit the OSM_FILENAME environment variable in docker-compose.yml file to select the downloaded OSM file.
   • The default is monaco-latest.osm.pbf which was downloaded in step 3.
5. Run docker-compose up
   • Since the import process is long, the n7m-app container terminates after 10 seconds. Run docker-compose up again after import so it restarts.
6. Browse to: http://localhost:8080

⁠Additional Commands

1. To reset the database:
   • docker-compose run feed reset
2. To run setup again:
   • docker-compose run feed setup
3. To update once:
   • docker-compose run feed update
4. To run replication:
   • docker-compose run feed replication

⁠Configuration Hints

For updates, consider these configurations:

• NOMINATIM_REPLICATION_MAX_DIFF - you will want to set this to a larger number.
• NOMINATIM_REPLICATION_URL - you will want to set this to a closer mirror.

⁠AWS EC2

To run n7m in AWS, the minimum EC2 Instance sizing is:

• Instance: m5.4xlarge - 64 GB RAM, 16 vCPUs
• Storage: 350GB SSD for North America

⁠Instance Comparison

• Instance: m5.4xlarge - 64 GB RAM, 16 vCPUs, 0.768/Hour
  • North America: 14.12 hours = $10.84
• Instance: m5.8xlarge - 128 GB RAM, 32 vCPUs, 1.536/Hour
  • North America: 10.57 hours = $16.23

⁠Resources

• Nominatim Web Site⁠
• Finding places: an introduction to Nominatim⁠
• OpenStreetMap⁠
• OpenStreetMap Data Extracts⁠