X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/84403b47cbdf3487dfcc6dd690e85bb04b6f3ccf..95de411a816ad381a259dd6ae596eb0d493d94c9:/docs/admin/Setup-Nominatim-UI.md diff --git a/docs/admin/Setup-Nominatim-UI.md b/docs/admin/Setup-Nominatim-UI.md index 818ea408..374a84e1 100644 --- a/docs/admin/Setup-Nominatim-UI.md +++ b/docs/admin/Setup-Nominatim-UI.md @@ -10,15 +10,20 @@ installation. For more details, please also have a look at the ## Installing nominatim-ui -nominatim-ui does not need any special installation, just download, configure -and run it. +We provide regular releases of nominatim-ui that contain the packaged website. +They do not need any special installation. Just download, configure +and run it. Grab the latest release from +[nominatim-ui's Github release page](https://github.com/osm-search/nominatim-ui/releases) +and unpack it. You can use `nominatim-ui-x.x.x.tar.gz` or `nominatim-ui-x.x.x.zip`. -Clone the source from github: +Next you need to adapt the UI to your installation. Custom settings need to be +put into `dist/theme/config.theme.js`. At a minimum you need to +set `Nominatim_API_Endpoint` to point to your Nominatim installation: - git clone https://github.com/osm-search/nominatim-ui + cd nominatim-ui + echo "Nominatim_Config.Nominatim_API_Endpoint='https://myserver.org/nominatim/';" > dist/theme/config.theme.js -Adapt the configuration `dist/config.js` to your needs. You need at least -to change the `Nominatim_API_Endpoint` to point to your Nominatim installation. +For the full set of available settings, have a look at `dist/config.defaults.js`. Then you can just test it locally by spinning up a webserver in the `dist` directory. For example, with Python: @@ -66,11 +71,11 @@ map $args $format { ~(^|&)format= other; } -# Determine from the URI and the format parameter aboce if forwarding is needed. +# Determine from the URI and the format parameter above if forwarding is needed. map $uri/$format $forward_to_ui { default 1; # The default is to forward. ~^/ui 0; # If the URI point to the UI already, we are done. - ~/other$ 0; # An explicit non-html format paramter. No forwarding. + ~/other$ 0; # An explicit non-html format parameter. No forwarding. ~/reverse.*/default 0; # Reverse and lookup assume xml format when ~/lookup.*/default 0; # no format parameter is given. No forwarding. } @@ -87,14 +92,14 @@ rewrite ^/$ /search; location @php { # fastcgi stuff.. if ($forward_to_ui) { - rewrite ^(/[^/]*) http://nominatim.loar/ui$1.html redirect; + rewrite ^(/[^/]*) https://yourserver.com/ui$1.html redirect; } } location ~ [^/]\.php(/|$) { # fastcgi stuff.. if ($forward_to_ui) { - rewrite (.*).php http://nominatim.loar/ui$1.html redirect; + rewrite (.*).php https://yourserver.com/ui$1.html redirect; } } ```