Skip to content
Full MapOsMatic installation in an Ubuntu VM
Branch: master
Clone or download


Performs a full MapOsMatic installation in an Ubuntu 15.10 VM using Vagrant and shell provisioning


The following components will be installed into the VM:

  • OCitysMap rendering backend (from my own modified fork)
  • MapOSMatic web frontend (again from my own fork)
  • Stylesheets:
  • Current OSM default style
  • MapOSMatic Printable style
  • HikeBikeMap style
  • Humanitarian style (HOT)
  • MapQuest European style
  • German style
  • Overlay stylesheets:
  • Golf overlay
  • Fire Hydrant overlay


  • A working Vagrant / Virtualbox setup

  • A minimum of 2GB available RAM for the VM and a working internet connection

Installation and useage

  • Copy a OSM PBF extract of your choice into this directory. If multiple files with ending '.pbf' are found only the first one is used.
  • Run "vagrant up"
  • Be patient ...
  • First build can take quite a while as it needs to compile Mapnik from scratch, this step gets much faster as Ccache is used and its cache files are preserved outside the VM
  • The stylesheets require quite some extra downloads, and some processing on these (shape files, height information, ...). The downloads are cached localy, so this only happens on the first start mostly.
  • Importing the provided OSM PBF file can take some time, too, depending on its size ...
  • Once the VM is fully started and provisioned you can use your MapOsMatic instance on http://localhost:8000/
You can’t perform that action at this time.