Awesome Open Source
Awesome Open Source

OSM Scout Server

Matrix TMO

OSM Scout server can be used as a drop-in replacement for online map services providing map tiles, search, and routing. As a result, an offline operation is possible if the device has a server and map client programs installed and running.

Among other services, the server can be used to provide:

  • vector or raster tiles for other applications;
  • search for locations and free text search;
  • search for POIs next to a reference point or route;
  • calculating routes between given sequence of points;

User's guide is available at .

The server supports:

To use the server, you have to start it and configure the client to access it. An example configurations for JavaScript-based clients are provided under "example" folder. At present, Pure Maps, uNav, and modRana include plugins already in the upstream and no additional configuration is needed.

The server is written using Qt. The server consists of a daemon and separate GUI application for Sailfish, Kirigami, Ubuntu Touch, or a QtQuick application. Installation instructions are given in INSTALL.

User feedback

There are three main communication channels with the users: GitHub, Matrix channel and a thread at TMO. Matrix channel is shared with Pure Maps.

Please use Github issues to address specific problems and development requests. General discussion is expected either through corresponding issues, Matrix channel, or TMO thread. Please note that users from all platforms are welcome at TMO, not only current Sailfish OS users.


Starting from version 0.7, the server uses maps distributed via online distribution network. It is expected that the users would download, update, and, when needed, remove maps via server's GUI/CLI. This distribution model allows users to specify which components are required (libosmscout, geocoder-nlp, for example) and download only the required components.

If tinkering is required, it is still possible to import the maps manually. However, in this case, the user is expected to incorporate the manually imported maps into configuration JSON file describing that map and use specific developer options.

Maps distribution and data

Maps are hosted by Natural Language Processing Centre ( , Faculty of Informatics, Masaryk University, Brno, Czech Republic) through modRana ( data repository.

Map data from OpenStreetMap, Open Database License 1.0. Maps are converted to a suitable format from downloaded extracts and/or using polygons as provided by Geofabrik GmbH.

UK postal codes downloaded from These data contain: Ordnance Survey data © Crown copyright and database right 2017; Royal Mail data © Royal Mail copyright and database right 2017; National Statistics data © Crown copyright and database right 2017.


Configuration settings are in ~/.config/osmscout-server/osmscout-server.conf and this file is initialized on the first start. For Sailfish version, add prefix harbour- to the file and directory name.

In configuration file you can specify server HTTP port and the interface. In addition, map directory with several rendering options are configured. In Sailfish, map rendering options are possible to specify through GUI.

Starting from version 0.3.0, server supports up to 100 connections. The requests are processed in parallel, as much as possible, with the number of parallel threads the same as the number of CPUs. Depending on the used backend, one operation can block other operations due to the blocking of the corresponding database. Exceeding the number of supported connections would lead to dropping the connections exceeding the limit.

API and Adding support for OSM Scout Server to map clients

Exported API and what to consider while adding support for the server by a map client, see separate README.api.


Custom icons used by the application were contributed by Fellfrosch (from


Up to date contribution of translations are given in the About page of the application for corresponding language.

For translations, please see


Please note that libpostal is developed to be used with the fine tuned model covering the World. The country-based models were developed to use libpostal in mobile devices and have not been specifically tuned. Please submit the issues with libpostal performance on country-based models to OSM Scout Server or geocoder-nlp github projects.








GNU Libmicrohttpd:


Mapbox GL import scripts:

Hosting of maps: Natural Language Processing Centre ( , Faculty of Informatics, Masaryk University, Brno, Czech Republic) through modRana (

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
c-plus-plus (18,567
linux (2,465
navigation (262
maps (173
offline (162
geocoder (33
vector-tiles (32
mapbox-gl (26