OSM Scout Server

Your rating: None Average: 5 (47 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.

Starting from 0.7.0 release, maps are distributed online and should be downloaded through provided Map Manager interface.

NB! When Mapbox GL schema is changed (as for 1.4.0), please remove Mapbox GL application caches. For Poor Maps GL, you have to run

rm -rf ~/.cache/harbour-poor-maps-gl

in the terminal.

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.6.0-10.40.1.jolla_.armv7hl.rpm9.94 MB27/05/2018 - 07:04
File harbour-osmscout-server-1.6.0-10.40.1.jolla_.i486.rpm10.65 MB27/05/2018 - 07:04
File harbour-osmscout-server-1.7.1-1.48.1.armv7hl.rpm10.06 MB17/06/2018 - 10:33
File harbour-osmscout-server-1.7.1-1.48.1.i486.rpm10.77 MB17/06/2018 - 10:33
File harbour-osmscout-server-1.8.0-1.64.1.armv7hl.rpm11.43 MB12/07/2018 - 22:59
File harbour-osmscout-server-1.8.0-1.64.1.i486.rpm12.29 MB12/07/2018 - 22:59
File harbour-osmscout-server-1.9.1-1.76.1.i486.rpm12.3 MB31/07/2018 - 15:54
File harbour-osmscout-server-1.9.1-1.76.1.armv7hl.rpm11.43 MB31/07/2018 - 15:54
File harbour-osmscout-server-1.10.2-1.90.1.armv7hl.rpm11.44 MB20/08/2018 - 13:15
File harbour-osmscout-server-1.10.2-1.90.1.i486.rpm12.31 MB20/08/2018 - 13:15
File harbour-osmscout-server-1.10.5-1.93.1.armv7hl.rpm11.44 MB27/08/2018 - 18:26
File harbour-osmscout-server-1.10.5-1.93.1.i486.rpm12.32 MB27/08/2018 - 18:26
File harbour-osmscout-server-1.11.0-1.96.1.armv7hl.rpm11.45 MB05/09/2018 - 21:23
File harbour-osmscout-server-1.11.0-1.96.1.i486.rpm12.32 MB05/09/2018 - 21:23
File harbour-osmscout-server-1.12.2-1.103.1.jolla_.armv7hl.rpm11.47 MB01/11/2018 - 08:51
File harbour-osmscout-server-1.12.2-1.103.1.jolla_.i486.rpm12.35 MB01/11/2018 - 08:51
File harbour-osmscout-server-1.13.0-1.106.1.jolla_.armv7hl.rpm11.68 MB03/12/2018 - 23:16
File harbour-osmscout-server-1.13.0-1.106.1.jolla_.i486.rpm12.64 MB03/12/2018 - 23:16
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

1.13.0, 1.13.1

  • add postal code as a name for some search results
  • docs: update Spanish User's manual
  • docs: add Linux install instructions
  • mapboxgl backend: use sqlite3pp instead of Qt SQL
  • flatpak: update build scripts and move them to flathub
  • [1.13.1] updated translations

1.12.0, 1.12.1, 1.12.2

  • geocoder: add support for search by postal codes
  • geocoder: return postal codes, phone, and webpage when available
  • geocoder: load libpostal language classifier and parser only if needed
  • [1.12.0, 1.12.1] update translations
  • [1.12.2] added boost lib to the package to support SFOS3


  • update translations
  • allow searching without libpostal parsing
  • allow nearby search without type and name


  • update translations
  • update Valhalla to 2.6.3
  • update Valhalla configuration
  • other small changes

1.10.0, 1.10.1, 1.10.2

  • changed license to GPLv3
  • add support for POST requests
  • add search along route
  • cleanup POI aliases handling
  • added Italian translation [wip]
  • updated translations
  • geocoder bugfixes


  • updated translations
  • fix crash when using libosmscout profile
  • fixes in map matching service
  • add ferries and oneway streets in MapboxGL styles


  • introduction of D-Bus API
  • map matching of the current position as D-Bus service
  • updated translations


  • use Valhalla C++ API
  • expose multiple Valhalla's services
  • add Mapbox GL car styles
  • update translations
  • other small changes

1.7.0, 1.7.1

  • support for aliases in multiple languages in guide search
  • support for POIs without a name in guide search
  • extend API for guide search by specified type and/or name
  • provide the list of currently used aliases
  • sort guide results by distance
  • adjusted lists of imported types for geocoder-nlp
  • other enhancements and bugfixes in geocoder-nlp
  • updated translations


  • addition of QtQuick Controls GUI version
  • update geocoder to libpostal 1.1 API
  • adjust geocoder results sorting
  • changes in Valhalla packaging
  • added nl_BE translation
  • updated translations
  • moved Silica QML into separate folder
  • show map selection only if needed


  • revise warning messages on missing backend data
  • notify about missing modules only if required by selected backends
  • source tree and compilation enhancements


  • Updated translations
  • Fix Mapbox GL style to show rivers
  • Preserving explicit dependency on libsystemd at Sailfish


  • Updated translations
  • Support for multiple Mapbox GL icon packs
  • Addition of Mapbox GL dark style


  • Updated Mapbox GL tile schema
  • Mapbox GL style with English names
  • Document starting and using the server
  • Document details on automatic activation of the server
  • Updated translations


  • Support for multiple map download servers
  • Ensure that Valhalla is started before starting HTTP service
  • Updated translations
  • Added donations link


  • Add support for MapboxGL
  • Updated translations of documentation and application

1.1.0, 1.1.1

  • Add automatic start via systemd socket activation
  • Updated translations


  • Normalize tile indexes if requested out of range

1.0.0, 1.0.1

  • Users Guide in Spanish
  • Addition of Finnish translation
  • Updated translations


  • Revert to older libosmscout
  • Updated translations


  • Geocoder-NLP update
  • Updated translations


  • Add support for English as a secondary language
  • Deleting files during cleanup in separate thread
  • Updated translations
  • Bugfixes


  • Updated translations
  • Bugfix in guide search


  • Introduction of profiles
  • Startup wizard
  • Updated translations
  • Other small changes


  • Add support for Mapnik style and daylight switching
  • Speedup Mapnik backend by removing double scaling of the buffer
  • Updated translations


  • Add guide search support for Geocoder-NLP
  • Guide search looks for type or name when using Geocoder-NLP
  • Support for V2 routing protocol by libosmscout backend
  • Updated translations
  • Other smaller changes


  • Updated translations


  • Valhalla added as a routing engine
  • Routing is supported between different territories when using Valhalla
  • Search is performed for all databases when using Geocoder-NLP
  • Server is distributed using modular approach
  • Two server modules introduced: Route and Fonts
  • Update libosmscout version, 20170521
  • Make storage of libosmscout databases optional
  • Mapnik uses Noto fonts by default
  • Other smaller changes

0.9.5, 0.9.6

  • Mapnik database schema changes to reduce size and speedup rendering
  • Mapnik renderer default style adjustments
  • Updated translations


  • Mapnik added as an alternative map rendering backend
  • Enhance Linux command line support for map subscription


  • Updated translations
  • Fix start error on i486


  • Optimization of geocoder-nlp, changes in geocoder data format
  • Updates from libosmscout upstream
  • Addition of command line options
  • Updated translations


  • Expose map updates to GUI
  • Propose to create a storage folder (suggested by @Feathers McGraw)
  • Updated translations


  • New transalations completed: French, Russian
  • New translations started: Polish, Norwegian
  • Fix buffer overflow during fast download and slow writing


  • Updated translations
  • Improved handling of some network errors during download


  • Maps are provided through CDN
  • Adding Map Manager to download and remove maps on the device
  • libosmscout backend changes, including rendering speedup by @Karry
  • Settings grouped by backend and available via Settings dialog
  • Small enhancements


  • German translation
  • Moving translations to Transifex
  • Start and target description are given when available


  • Updated Spanish and Swedish translations


  • Adding libpostal-based geocoder
  • Update to the latest libosmscout version
  • Updated Spanish and Swedish translation


  • Swedish translation


  • Czech translation
  • Minor update in search


  • Updated Spanish translation


  • Added file and directory selection dialog
  • Support for metric and imperial units
  • Built against libosmscout 0.0.git.20161207


  • Updated Spanish translation


  • Changes for better localization support
  • Spanish translation
  • GUI shows number of jobs in queue
  • Support for routing cost limits
  • Bugfixes in routing (libosmscout library)


  • Decoupling number of parallel processing threads and number of requests
  • Adding GPX output for router
  • Adding ability to log events into session log file
  • Using libmicrohttpd as a http server engine
  • Bugfixes in routing
  • Static linking of libosmscout, marisa, and libmicrohttpd
  • Used versions of the libraries: libosmscout (0.0.git.20161110), marisa (0.2.4), libmicrohttpd (0.9.50)


  • Bug fix in routing target description; small changes in route instructions text


  • Support for route calculation
  • Add settings for transport speed properties
  • Add ability to increase area processed for tile drawing
  • Small enhancements and bug fixes


  • Initial release
  • Support for map tiles
  • Support for location search
  • Support for free text search
  • Support for search of POIs next to a reference point


dirksche's picture

Thanks.That would be great.

dirksche's picture

Thank you for this application. It's just great. I use it together with PureMaps. Just a little question: is there any offline map (germany) that shows railway stations? Thunderforest offline would be great.

rinigus's picture

I will have to make specific style for highligting public transport using the same data as currently used on the maps. Have been busy with Pure Maps lately, but will get to the server development at some point (don't want to use soon in this context)

elastic's picture

Hi ringus, many thanks for your apps! One little question: is it (or will it be sometimes) possible to use vector maps from other sources like openandromaps (the best maps for hiking) many thanks again

rinigus's picture

Please see https://github.com/rinigus/osmscout-server/issues/297 . Its possible, but right now its hard to find time for it due to the other issues in front of the queue.

elastic's picture

OK, thanks -  easiest for users would be just a import feature - no idea how much work that means on the dev side ... 

rinigus's picture

due to selected backends, it way complicated. but if implemented, the easiest for users would be just download, wouldn't it? :)

ljutica's picture


Wifi - i can't download, big problems

4G - 2 country I've download ( cca 400 mb, and cca 900 mb)

Because of the price, I would prefer wifi ......

rinigus's picture

OK, it maybe some problem with the Sailfish port for your device. I don't see how otherwise camera could be influenced as well as why wifi wouldn't work while 4G does. Please ask for help from your port maintainer (XDA or #sailfishos-porters).

rinigus's picture

Camera interaction is strange, no idea where that's coming from. Let's try the following : put the phone on charger and try to download while on charger. This will prevent phone going to sleep and may help us. If its insufficient, try to move away current folder, make a new one and start with some small territory (download while on charger). Let me know how it goes. Also check the logs of the server (shown on the main screen), maybe we can get some info from there.

ljutica's picture

I used new folder, Azores 54 mb size, same thing happened.

When you wrote check logs of the server - did you think about this :



Im downloading with wifi - not over network -3G,4G...


Il try clean install sailfish, then basic software (email...) then pure maps, server scout.

rinigus's picture

Logs are shown on the first screen of the server. See the first screenshot at openrepos, under events section.

rinigus's picture

That's new, don't remember seeing such error. Can you please check permissions for that folder by creating a folder inside it with the file manager, for example. In addition, how much free space do you have?

ljutica's picture

Permisions looks god (I've used Maps.OSM-default option):


I create folder and there was no problem:




When I release a download, after a while, it shows that message. I try to start the camera, the screen is black and I can not switch to the front camera. Can not use video capture. I reset the phone all ok, until I start downloading the maps.


Used 2,7 gb, free space 20 gb.

ljutica's picture

Several times clean install of sailfish os v - Xiaomi redmi note 4 global version

Every time I try to download a country map I get this error:



I'm installing to memory from the phone . I do not understand what the mistake is.

scanner's picture

on the tablet i can not install version 1.12. - storeman does not see it. manual install hangs (turns forever). but also existing version 1.11 does not start.

i just updated to sailfish 3. but it did not work before also.

rinigus's picture

have you tried pkcon refresh?

247's picture

seems that osmscout it's not compatible with sf 3 as it does not open, and maps on poor maps are not working at all :)

rinigus's picture

should be fixed now with the new version

247's picture

Yep, thanks

ABreen's picture

It's happened to me on the last two updates fir some reason.

rinigus's picture

Did all maps required an update or just a part of them? If I recall correctly, I have updated Valhalla a bit later to incorporate public transport data and maybe that caused the second update. In general, I try to update maps once in 2 month, as a compromise between keeping them reasonably fresh and, on the other hand, not to spend all time on maps updates

ABreen's picture

Why the need to re download maps after each update? The map download process is excruciatingly slow.

rinigus's picture

No, its not after each update. Usually, you are forced to download new maps when the format changes. When updating to 1.12.x from earlier versions, you will be using new geocoder database format that support postal codes and adds few properties for searched items. Hence the latest download.

crakby's picture

Ok. Thank you.

crakby's picture

One further question:

does the OSM scout server poi datas contain the "tags" like the online version?


Because there are important to describe the poi. In pure maps, only the address is shown.

rinigus's picture

It should also show that its Caravan Site. No, not all tags are stored. LEt me know which are important and we can look into it. Currently, its the main type, phone, www, postal code. Its not very easy to extend due to the used import pipeline, though

crakby's picture

If I search the place in my example, pure maps shows the main type and the address, the contact:phone and contact:website are't displayed.

Important for this type of POI:


rinigus's picture

Please file an issue at github. I am not sure whether it will be implemented, I will have to see how and when I can do it. But its still good to file the issue to not forget about it.

crakby's picture


I found a small misbehavior:

If I search for postal code or points of interests along the route with pure maps, I only get results if the same associate map (region) is selected in OSM scout server. In coutrys like france I have no option to download the whole country, so if I have a place near or a route to next departement, the search results are empty, the nearby only shows until department border.

In OSM scout server should be a option to choose all maps or a group of.

If I serach for a city, I get results of cities even outside of the choosen map. pure maps starts the osm scout server in background, so I need to remember to open it manually and change the map. Or do I miss something out?