OSM Scout Server

Your rating: None Average: 5 (77 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! For SFOS < 4.1 users - starting from 2.0.2 release, SFOS is required for the builds published at OpenRepos. For older SFOS, please use OBS.

OBS: https://build.merproject.org/project/show/home:rinigus:maps




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.

Application versions: 
File harbour-osmscout-server-1.13.1-1.107.1.jolla_.armv7hl.rpm11.67 MB01/02/2019 - 00:01
File harbour-osmscout-server-1.13.1-1.107.1.jolla_.i486.rpm12.65 MB01/02/2019 - 00:01
File harbour-osmscout-server-1.14.5-1.116.1.jolla_.armv7hl.rpm5.82 MB23/05/2019 - 08:04
File harbour-osmscout-server-1.14.5-1.116.1.jolla_.i486.rpm6.61 MB23/05/2019 - 08:04
File harbour-osmscout-server-1.15.0-1.119.1.jolla_.armv7hl.rpm6.17 MB22/09/2019 - 08:29
File harbour-osmscout-server-1.15.0-1.119.1.jolla_.i486.rpm7.01 MB22/09/2019 - 08:29
File harbour-osmscout-server-1.15.5-1.120.1.jolla_.armv7hl.rpm6.18 MB29/10/2019 - 23:45
File harbour-osmscout-server-1.15.5-1.120.1.jolla_.i486.rpm7.01 MB29/10/2019 - 23:45
File harbour-osmscout-server-1.15.6-1.125.1.jolla_.armv7hl.rpm6.68 MB30/11/2019 - 16:09
File harbour-osmscout-server-1.15.6-1.125.1.jolla_.i486.rpm7.58 MB30/11/2019 - 16:09
File harbour-osmscout-server-1.16.0-1.127.1.jolla_.i486.rpm7.65 MB23/01/2020 - 19:32
File harbour-osmscout-server-1.16.0-1.127.1.jolla_.armv7hl.rpm6.72 MB23/01/2020 - 19:32
File harbour-osmscout-server-1.16.1-1.129.1.jolla_.i486.rpm8.25 MB07/05/2020 - 20:39
File harbour-osmscout-server-1.16.1-1.129.1.jolla_.armv7hl.rpm6.97 MB07/05/2020 - 20:39
File harbour-osmscout-server-1.17.0-1.132.1.jolla_.armv7hl.rpm6.97 MB25/07/2020 - 19:39
File harbour-osmscout-server-1.17.0-1.132.1.jolla_.i486.rpm8.25 MB25/07/2020 - 19:39
File harbour-osmscout-server-1.17.1-1.135.1.jolla_.armv7hl.rpm7.14 MB20/11/2020 - 22:18
File harbour-osmscout-server-1.17.1-1.135.2.jolla_.i486.rpm8.43 MB23/11/2020 - 22:23
File harbour-osmscout-server-2.0.0-1.137.1.jolla_.i486.rpm7.97 MB29/03/2021 - 22:50
File harbour-osmscout-server-2.0.0-1.137.1.jolla_.armv7hl.rpm6.78 MB29/03/2021 - 22:50
File harbour-osmscout-server-2.0.1-1.aarch64.rpm6.93 MB16/04/2021 - 21:28
File harbour-osmscout-server-2.0.2-1.aarch64.rpm6.93 MB16/05/2021 - 21:49
File harbour-osmscout-server-2.0.2-1.armv7hl.rpm6.79 MB16/05/2021 - 21:49
File harbour-osmscout-server-2.0.2-1.i486.rpm7.99 MB17/05/2021 - 17:43


rinigus's picture

That's one of the main reasons why the Default profile enables these backends.

cybershaman's picture

rinigus: thank you for all your great work on this app, it has made my life easier numerous times when abroad.
Is there a technical reason why you opt to having the map server run in foreground (cover) mode only compared to letting it run in background (possibly on SFOS bootup) also?

rinigus's picture

You are welcome! There are few reasons behind such design:

  • Jolla Store does not accept daemons. So, if I want to distribute in the both places, versions would differ and the code will have to be properly #ifdef'd
  • If I make it as a daemon, I would have to communicate changes in settings, maps, and so on. In one application its just a bit easier.

Its possible that I will add daemon mode, but that's not priority yet.

DrYak's picture

I second the request for daemon mode.

rinigus's picture

I added the issue https://github.com/rinigus/osmscout-server/issues/176 . However, note that its lower priority right now. I would like to work on other aspects of the navigation first.

olf's picture

[Daemon or not] For the apps "Situations" and "Find my Jolla" (both in Jolla Store), the solution was to create a separate autostarter for each (both available in Warehouse). Technically, this is not elegant, but that approach works well and avoids conflicting with Jolla's Store guidelines.

Apart from this (i.e. separately), I believe a way to hide the UI on startup of OSM Scout Server would be useful.
Just a spontaneous idea: OSM Scout Server could e.g. generate a notification in the SFOS eventsview when starting (already does that), with which (by tapping on it) its GUI is started (in order to access the GUI, when OSM Scout Server was started without it).

rinigus's picture

@olf, sorry, I forgot to reply to you. I have added your suggestions to github issue to keep all data in the same place. Will look into it when I have finished few other things

olf's picture

Absolutely fine, I have already seen that on github. :)

Thanks for planning to take a look at this; making an automatic start-up without GUI possible would be really nice, and hopefully I managed to point out an easier way to achieve that.

Bramba's picture

Hello rinigus,

thank you very much for your great work and your useful app! :-)

There is one question from my side: If I use Poor Maps or Sailfish Maps in (classic) online-mode, I get the maps displayed in my origin- or in english language (what is great!). However, if I switch on OSM Scout Server and use Poor Maps in offline-mode, I get the map displayed in the language of the country itself. That means, for example in China, I can only see those non-understandable foreign characters instead of city- or streetnames in English language.

When navigating around Asia, it feels very difficult to learn all those foreign characters before switching on the engine... :-)

Is there any option available to select the provided language for foreign countries?

With best regards and thank you!

rinigus's picture
ade's picture

Is there a manual download alternative left? The map download keeps on throwing timeouts and the postal part as a separate download keeps on getting killed by the OOM-killer (mem usage gets around 50%). This postal download is "just" 705MB.

rinigus's picture

Hi! The manual downloads are not available anymore (or more specifically, at present). See TMO thread for details. But let's try to figure out what's going on with your installation and see how I can fix it.

Do I understand correctly that the server gets killed while downloading only and not doing anything?

Either its a bug in my code or there is something that I did not anticipate in your setup. One possibility for large RAM usage could be that your download speed exceeds write speed on storage or its processing by bunzip2. Is this possible? I presume that then some internal buffers could get full and get OOM-killer up. It might also initiate some timeout stops since network download is not bringing any bytes in (waiting for writing).

To test whether timeouts are causing some trouble, try to use 0.7.0 version. That version has a more straightforward download implementation. It wouldn't save you against some other issues, but may help here.

Would you mind to tell which hardware do you use it on and where do you write the maps (internal or external storage)?

Yes postal download is big, but you don't have to use it. It "just" allows you to use a new geocoder :).

Please do report back and tell how is it going. You could use TMO/github/or here. I would like to fix this issue and ensure that everything works as it should.

ziellos's picture

I can confirm the described behaviour. After switching to geocoder-nlp, the download of "Adressanalyse Sprachunterstützung" always stops when < 10 MB of data are remaining (message is "Fehler beim Herunterladen [path]/postal/global/language_classifier/language_classifier.dat" - Timeout).

And your assumption about memory usage is correct. If download is faster than unzipping and writing, the buffer fills up to several hundred MBs (which is not a problem on my Aqua Fish). Doing the same on Jolla 1 with limited RAM may cause the process being killed.

But apart from that issue, your app is simply stunning. I don't know any other app in Sailfish-land of comparable complexity which is that easy to setup and use. The combination of Poor Maps and OSMScout Server may easily outperform Here Maps (Android). Thanks a lot for your work!!!

rinigus's picture

This bug has been fixed, as from yesterday's morning. Fix description: https://github.com/rinigus/osmscout-server/issues/89 . I am preparing for a new release and will few hours for translations before packaging and releasing new version later today. Right now the test version with the fixed bug is distributed as explained at http://talk.maemo.org/showpost.php?p=1525204&postcount=131

Thank you very much for your warm words, its great to know that the work is appreciated!

ziellos's picture

The download issue is now solved. Again, many thanks!

rinigus's picture


ade's picture

I will create a github issue then. Nice to see your drive to fix issues.

mase's picture

Can it provide multiple maps (one per country), or only one a time?

rinigus's picture

Unfortunately, not yet. I have opened issues in github to address that, but there are few other things that I have to fix first. The situation is somewhat more difficult from 0.6.x releases and my priority is to simplify that part with the next release.

The map that you select in general settings, is a map for libosmscout. This map you can either download using OSM Scout application by Karry or make yourself with the importer. If you make it yourself, you can easily generate a map covering several countries. See links at https://github.com/rinigus/osmscout-server#maps

For the new geocoder part, few other databases are needed. I think its impractical to generate libpostal datasets (you need big server with lots of data for it). Those you have to download from links provided at TMO thread. The geocoder database is easier to make, but not trivial (you would need linux PC, installed libpostal, libosmscout, and run geocoder-nlp/importer). That's why I also generate them and distribute together with libpostal database. These databases are made usually one per country. For some countries they are relatively big, but the search speed should be OK in the latest version.

monkeyisland's picture

hi is german language for routing possible?

rinigus's picture

Sure! Its just that the routing instructions would have to be translated. So far, we have translations for Spanish, Swedish, and Czech. If you wish, you could translate it as well and submit the changes via github project page.

naalaa's picture

Hallo rinigus, i installed osm scout server in the latest version on Jolla 1, i downloaded a map from you (germany) and i use poormaps and modrana as clients. Everything works without problems. Very good work. So I want to spend some money for the further work. But I did not find any way to send some money. Maybe you integrate a Button here e.g. pay with paypal or something like this.

rinigus's picture

Thank you very much for your kind words! I am doing it as a hobby and its OK as it is. Its possible that we would need to start taking donations to cover expenses with distribution of the maps for libosmscout or for accessing the other servers via Poor Maps or modRana. Then the situation would possibly change.

As for now - enjoy the server and the clients :)

Reposser's picture

Doesn't install:

Sailfish screenshot with error message

I'm just a user. Unfortunately, I don't have the time and the knowledge to fiddle around with workarounds. It would need to work out of the box.

rinigus's picture

It seems that sometimes Jolla repos get messed up. You might need to refresh the repos. See posts on http://talk.maemo.org/showthread.php?t=97823&page=2

Note that you would have to convert maps as well. A first shot on simpler importer is given in the last post of that thread in TMO. But its not all point and click and requires Linux PC.

makinit's picture

It takes some effort to import the OSM data, but after that it works seamlessly with Poor Maps.

rinigus's picture

Thank you for using it! Indeed, import is probably the hardest thing that's left. I am looking into how to make it simpler. Until I figure out how to distribute the Import tool, keep the sources around. The maps database is evolving to cover routing functionality and you may have to run import commands again from newer version of the library in future.

naytsyrhc's picture

Hi, great idea and I'd love to test it. Unfortunately I can't install it on SFOS, I get the warning/error, that gmp- can not be found on medium https://releases.jolla.com/releases/

Probably a wrong dependency?

Thx for any help or hint.

rinigus's picture

Please see TMO thread. It seems that several users had the same problem and @nodevel suggested to refresh the repositories (pkcon refresh) to fix it.

naytsyrhc's picture

Yes thx. I got it installed now. So pkcon refresh seems to do the trick.