The following instructions explain how to create a Nominatim database
from an OSM planet file. It is assumed that you have already successfully
-installed the Nominatim software itself. If this is not the case, return to the
+installed the Nominatim software itself and the `nominatim` tool can be found
+in your `PATH`. If this is not the case, return to the
[installation page](Installation.md).
## Creating the project directory
Before you start the import, you should create a project directory for your
new database installation. This directory receives all data that is related
to a single Nominatim setup: configuration, extra data, etc. Create a project
-directory apart from the Nominatim software:
+directory apart from the Nominatim software and change into the directory:
```
mkdir ~/nominatim-planet
+cd ~/nominatim-planet
```
In the following, we refer to the project directory as `$PROJECT_DIR`. To be
The Nominatim tool assumes per default that the current working directory is
the project directory but you may explicitly state a different directory using
-the `--project-dir` parameter. The following instructions assume that you have
-added the Nominatim build directory to your PATH and run all directories from
-the project directory. If you haven't done yet, add the build directory to your
-path and change to the new project directory:
-
-```
-export PATH=~/Nominatim/build:$PATH
-cd $PROJECT_DIR
-```
-
-Of course, you have to replace the path above with the location of your build
-directory.
+the `--project-dir` parameter. The following instructions assume that you run
+all commands from the project directory.
!!! tip "Migration Tip"
Run this script to verify all required tables and indices got created successfully.
```sh
-nominatim check-database
+nominatim admin --check-database
```
Now you can try out your installation by running:
TIGER data to your own Nominatim instance by following these steps. The
entire US adds about 10GB to your database.
- 1. Get preprocessed TIGER 2019 data and unpack it into your project
+ 1. Get preprocessed TIGER 2020 data and unpack it into your project
directory:
cd $PROJECT_DIR
- wget https://nominatim.org/data/tiger2019-nominatim-preprocessed.tar.gz
- tar xf tiger2019-nominatim-preprocessed.tar.gz
+ wget https://nominatim.org/data/tiger2020-nominatim-preprocessed.tar.gz
+ tar xf tiger2020-nominatim-preprocessed.tar.gz
2. Import the data into your Nominatim database: