OSM Scout Server

Your rating: None Average: 5 (69 votes)

OSM Scout Server is a native offline maps provider. This server can be used as a drop-in replacement for online map services providing map tiles, search, and routing. As a result, together with the map client, a full offline solution is available for map search and navigation (car, bicycle, and walking).

The server can be used to provide:

  • map tiles for other applications;
  • search for locations and free text search;
  • search for POIs next to a reference;
  • calculate the route between two or more locations.

To use the server, you have to start it and configure the client to access it. Poor Maps and modRana have support for the server already with no additional configuration needed.

NB! Versions >=1.16.1 are using compiler included in SFOS 3.3.0.x and are not compatible with the earlier SFOS versions

NB! For SFOS <=3.0.2.x users - do not upgrade here to versions >=1.14.3. Use OBS instead: http://repo.merproject.org/obs/home:/rinigus:/maps/sailfish_3.0.2.8_armv...


Specific update instructions:

1.15.0 Valhalla database format has been updated. Please update maps after installation.

1.14.3 I suggest to uninstall old version of the server, check if anything stayed in /usr/share/harbour-osmscout-server and if that folder is there and/or not empty, remove it using devel-su. After that, install a new version (1.14.3 and up).

NB! When Mapbox GL schema is changed (as for 1.4.0), please remove Mapbox GL application caches.

NB! When a new backend is added, such as with the release of 0.9.0 and 0.10.0, please ensure that you have subscription information updated. For that, in Map Manager, click on "Check for updates", decline updates, and unsubscribe/subscribe each territory that you have subscribed. After that, proceed with the downloads. This is not needed if you don't want to use the added backend(s).

For detailed up-to-date description, please see https://github.com/rinigus/osmscout-server/blob/master/README.md

License: GPL
Source code: https://github.com/rinigus/osmscout-server

User's guide: https://rinigus.github.io/osmscout-server

Official TMO thread: http://talk.maemo.org/showthread.php?t=97823

Donations: https://rinigus.github.io/donate

Screenshots show the running server and, as an example client application, Poor Maps accessing the map tiles and calculated route prior to navigation.

Maps are hosted by Natural Language Processing Centre (https://nlp.fi.muni.cz/en/ , Faculty of Informatics, Masaryk University, Brno, Czech Republic) through modRana (http://modrana.org)
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.



lsjmhar's picture

Thanks. I selected that in osm but map still not appearing in modrana.

rinigus's picture

Please note that the documentation is somewhat outdated. I have opened an issue to address it and it will be a bit easier in future. But let's figure out what's wrong with your setup

rinigus's picture

To troubleshoot modRana: After you selected support for raster tiles in the server, did you download the maps? Does OSM Scout Server log say anything?

To test my assumption regarding vector tiles: Have you tried WhoGo Maps? Did it work with that?

crakby's picture

Ok. yes thank you for the hint. Where to go, if I found a wrong alias in German language for a tag?

rinigus's picture

We are planning to merge the tag aliases lists with the map clients. POC for WhoGo Maps is ready, have to polish it and do something similar for modRana. So, in future, you wouldn't have to know the tags before hand...

As for correction: German is at https://wiki.openstreetmap.org/wiki/Nominatim/Special_Phrases/DE

List of all available languages is at https://wiki.openstreetmap.org/wiki/Nominatim/Special_Phrases


crakby's picture

In the 'near by search' I have no matches anymore, since last update, if I searching for type 'caravan_site'. In the last version this type showed up.

rinigus's picture

Its easier now: please use 'caravan site' (or if you want to specify full tag, tourism_caravan_site). Full list of tags and their aliases is at https://rinigus.github.io/osmscout-server/tags/

hwansing's picture

I have problems with the automatic start of the server as a service: I have tried to enable "Automatic activation", but there are no systemd socket and service files created (.config/systemd/user/osmscout-server.service and .config/systemd/user/osmscout-server.socket). I have version 1.5.0-10.32.1.jolla at a Jolla 1 phone.

rinigus's picture

Strange, I cannot reproduce it - files are created if needed, activation works. This is on onyx Try to run from terminal and see if there is something printed that can help to debug it

hwansing's picture

Starting from terminal gives:


[nemo@Sailfish ~]$ harbour-osmscout-server
[D] unknown:0 - Using Wayland-EGL
[D] unknown:0 - "Unexpected reply signature: got \"\", expected \"a{sv}\""
[W] unknown:38 - file:///usr/lib/qt5/qml/Sailfish/Silica/private/Util.js:38: TypeError: Cannot read property 'parent' of null


I hope this helps...

If not: Could you mail me the contents of the systemd socket and service files, so that I can create the files by myself?

rinigus's picture

These are general error messages that seem to be coming from Silica layer. So, no help.

The contents of files is available at https://gist.github.com/rinigus/b9fe24551ba8f8e590d94a45761f4a54

With the files in place, it should be possible to enable/disable from OSM Scout Server. If that doesn't work either, then you would have to give corresponding systemctl --user command to enable the socket

However, its realy strange that you have this issue. Maybe something is wrong with permissions?

hwansing's picture

Hmm, permissions ....

.config/systemd/user directory is owned by root, and nemo is not allowed to create files or directories there. Maybe that's the problem?

rinigus's picture

That's surely a problem! I wonder why do you have such permissions. Change them to make owned by nemo and we are golden - all should be possible to do via the server (I mean enable/disable automatic activation )

hwansing's picture

Don't know why I have such permissions, I didn't set them by hand. They were set by the system. Nevertheless, I changed the oowner to nemo:nemo and it works fine. Thanks!

paolomi's picture

Hi :) Thanks for OSM Scout Server!

I'm translating valhalla in order to have localized routing and I want to test it before submitting it, so I ask you: have I to rebuild everything? or are there some tricks? (copy translated file somewhere?)

Thanks a lot

rinigus's picture

Paolomi, hi! Good question, I actually don't know. Note that I haven't updated Valhalla for a while and should do it soon. My main concern is that it may change database format, so I was thinking to synchronize update with new import. But when translation is ready, you should surely ping me when it gets upstream. It will be one more reason to make update.

As for testing, you could probably do it with the latest Valhalla on Linux PC or virtual machine.

paolomi's picture

Hi rinigus :) thanks for your reply.

I've updated italian translation because there is a problem with ordinal values, but they told me that "these are not meant for TTS engines anyway". I've not understood, so I'm asking them what to do. Please, have a look here:




EDIT: it's ok, now I've understood! It should be ok in the next update. Thanks for everything :)

rinigus's picture

Hi, I have updated Valhalla router (router module) which should include your translation as well. Enjoy!

247's picture

hi there,

so i have downloaded osmscout server and prior to downloading map is downloading me some 700 mb files (eg world coast limits and so on)...what are they?why can't be avoided?it's nice we can use osmscout with poor maps but with here we go i can have voices and my region's map with only 300 mb, it is really needed to download gb's of data?

rinigus's picture

Hi. It depends on the selected profile. If you can (hardware newer than J1), I would suggest to get Mapbox GL based map client WhoGo Maps. The initial download will be smaller for that. These data are world coastlines and address parser data (addresses can be parsed in almost any language).

247's picture

I am on j1 and whogo seems to work on that, i have in fact downloaded osmscout to try whogo, since description says that osmscout was needed for offline navigation...anyway i'll take your answer as a no :)

rinigus's picture

Take it as a no for now. The download that you are talking about is coming from language parser. There is a new version of the parser available which may reduce this part. However, I didn't manage to work on it yet.

eatdirt's picture

Hi there,

everything works fine for me, sdcard formatted ext4, but since the last update, I cannot subscribe anymore to "France" as a whole. In the directory listing, I can only see the regions, but no link to get the whole country. Under "Italy", this seems ok, I can get the whole, so it seems to be some server related mising links?





rinigus's picture

Hi Chris,

I dropped full France and Germany imports. For feedback I asked in the official TMO thread (https://talk.maemo.org/showpost.php?p=1540773&postcount=422) and since there was no general protest, decided to drop it. This makes it faster on my side (less huge imports), reduces double data on the servers (full country + regions). I took 4GB as a border and only these countries were affected.

Please download the regions and they should be automatically available as a joint entry from user's perspective (backends Mapbox GL, Mapnik, Geocoder-NLP, Valhalla). While you will see that reported sum is larger than before, the end space usage should be either the same or at least very similar.



eatdirt's picture


I have tried that before, but on Poor Maps, I was only getting one region at a time and not the whole country. I think that is because I am still using "libosmscout" as a rendering. I'll certainly switch to Mapnik then, but from past experience, "libosmscout"  was providing the fastest rendering on Jolla 1. Any chance to make it compatible with region boundaries?


Thanks again for the great app!



rinigus's picture

Yes, libosmscout backend doesn't support merging in the server. The newer versions of the library do support it, but the version used in the server does not. I have asked for someone to maintain libosmscout backend on it's developers list, but so far, there has been no volunteers. I personally use MapboxGL backend or, sometimes, Mapnik, hence interest on my part is limited and it would be better maintained by someone actively using it.

hwansing's picture

Hi, this app is really amazing, thanks! I had (apparently) the same problems as monkeyisland, the same error messages regarding "database image malformed". I tried to download hole Germany in one database, and that resulted in a 4,3GB big file - lying on a vfat filesystem (sdcard). However vfat is limited to 4GB file size :-)) So you need to format the sdcard as ext4, for example. Regards Holger

monkeyisland's picture

I have to say i also deleted the hole folder on sd card and let osm download the maps again. But no success

monkeyisland's picture

So i made a screenshot from the log:


rinigus's picture

Looks like there are problems with the huge databases like for Germany (and probably France). While it works on Linux PC, it sounds to me that its problematic for devices and I suspect that it maybe caused either by download problems or filesystem.

Please remove full Germany and download a part of it. Note that you can have multiple maps working at the same time. So, you can get full Germany downloaded by splitting it by regions. Please try with one region first and let me know if it helped.