Skip to content


Subversion checkout URL

You can clone with
Download ZIP
OpenStreetMap data to PostgreSQL converter
C++ Python CMake Lua Other
Latest commit c4023be @lonvia lonvia Merge pull request #506 from lonvia/reprojected-area
Add area reprojection facility
Failed to load latest commit information.
cmake remove all traces of pthread in makefiles
contrib/libosmium update libosmium to release version 2.5.1
docs remove whitespace before EOL
tests Add area reprojection facility
.gitignore Clean up gitignore, now that all build files are in a build dir
.travis.yml also remove boost-thread for travis and readme
900913.sql Add postgis definition for the 900913 spherical mercator projection w…
AUTHORS Hoffmann has two n's
CMakeLists.txt boost thread dependency no longer needed remove whitespace before EOL
COPYING * improved configure setup (including automake and libtool)
ChangeLog Revert "Remove the old SVN Changelog"
README Trim down README and move more detailed information into docs directory also remove boost-thread for travis and readme
TODO remove outdated gazetteer V1 code,
appveyor.yml make appveyor more verbose was missing from cygwin package. Merge branch 'upstream/master' into nocolumn remove whitespace before EOL
expire-tiles.cpp minimize variable scopes and coding style cleanup
expire-tiles.hpp clean up includes and remove unused rb.cpp
geometry-builder.cpp Add area reprojection facility
geometry-builder.hpp Add area reprojection facility
geometry-processor.cpp Replace boost::shared_ptr with std::shared_ptr
geometry-processor.hpp Replace boost::shared_ptr with std::shared_ptr
id-tracker.cpp avoid duplicates in job queues for pending ways and relations
id-tracker.hpp Add documentation to id_tracker remove whitespace before EOL remove whitespace before EOL
middle-pgsql.cpp middle-pgsql: use std::async for parallel indexing
middle-pgsql.hpp middle-pgsql: use std::async for parallel indexing
middle-ram.cpp Re-order headers in modified files
middle-ram.hpp constexpr was too complex for MSVC
middle.cpp Replace boost::shared_ptr with std::shared_ptr
middle.hpp Improve Doxygen syntax
multi.lua remove whitespace before EOL Fix builing typo in example multi style
node-persistent-cache-reader.cpp Replace boost::shared_ptr with std::shared_ptr
node-persistent-cache.cpp fix some warnings about int-size_t mismatch
node-persistent-cache.hpp Replace boost::shared_ptr with std::shared_ptr
node-ram-cache.cpp fix printf formats for 64 bit values
node-ram-cache.hpp remove whitespace before EOL
options.cpp Add area reprojection facility
options.hpp Add area reprojection facility
osm2pgsql.cpp remove custom o5m parser in favour of libosmium parser
osmdata.cpp workaround for multithreading locale problem in GEOS (MSVC)
osmdata.hpp Replace boost::shared_ptr with std::shared_ptr
osmtypes.hpp Rename tag to tag_t
output-gazetteer.cpp add missing include for std::cerr
output-gazetteer.hpp Merge pull request #467 from pnorman/include_cleanup
output-multi.cpp Move common polygon flag/formed into polygon logic together
output-multi.hpp Move common polygon flag/formed into polygon logic together
output-null.cpp Replace boost::shared_ptr with std::shared_ptr
output-null.hpp Replace boost::shared_ptr with std::shared_ptr
output-pgsql.cpp Add area reprojection facility
output-pgsql.hpp Replace boost::scoped_ptr with std::unique_ptr within osm2pgsql itself
output.cpp Replace BOOST_FOREACH with new C++11 for loops
output.hpp Re-order headers in modified files
parse-osmium.cpp ignore location for deleted nodes
parse-osmium.hpp remove custom o5m parser in favour of libosmium parser
pgsql.cpp Replace BOOST_FOREACH with new C++11 for loops
pgsql.hpp explicit type conversions to reduce MSVC warnings
processor-line.cpp clean up includes and remove unused rb.cpp
processor-line.hpp new types for keyval and for tag, member and node lists
processor-point.cpp move string conversion of geos geometries into wkt_t constructor
processor-point.hpp remove scale everywhere but in ramNode
processor-polygon.cpp clean up includes and remove unused rb.cpp
processor-polygon.hpp new types for keyval and for tag, member and node lists
reprojection.cpp Add area reprojection facility
reprojection.hpp Add area reprojection facility
sample.multi.json fix tab in sample multi config
sprompt.cpp Include config.h for HAVE_TERMIOS_H define
sprompt.hpp Renamed C files to C++ in preparation for destaticification.
style.lua remove whitespace before EOL
table.cpp fix some warnings about int-size_t mismatch
table.hpp Replace boost::scoped_ptr with std::unique_ptr within osm2pgsql itself
taginfo.cpp Move from NULL to nullptr
taginfo.hpp Removed a lot of static, global state variables from `output_pgsql_t`.
taginfo_impl.hpp Change proposed hstore flag to nocolumn
tagtransform.cpp remove whitespace before EOL
tagtransform.hpp Use foreach/auto loops in tagtransform
util.cpp replace printf with boost::format
util.hpp remove scale everywhere but in ramNode
wildcmp.cpp Clean up whitespace errors
wildcmp.hpp Wildcard matching should operate on const char arrays.
win_fsync.h fix headers and missing functions for MSVC/MinGW


osm2pgsql is a tool for loading OpenStreetMap data into a PostgreSQL / PostGIS database suitable for applications like rendering into a map, geocoding with Nominatim, or general analysis.


  • Converts OSM files to a PostgreSQL DB
  • Conversion of tags to columns is configurable in the style file
  • Able to read .gz, .bz2, .pbf and .o5m files directly
  • Can apply diffs to keep the database up to date
  • Support the choice of output projection
  • Configurable table names
  • Gazetteer back-end for Nominatim
  • Support for hstore field type to store the complete set of tags in one database field if desired


The latest source code is available in the OSM git repository on github and can be downloaded as follows:

$ git clone git://


Osm2pgsql uses the GNU Build System to configure and build itself and requires

It also requires access to a database server running PostgreSQL and PostGIS.

Make sure you have installed the development packages for the libraries mentioned in the requirements section and a C++ compiler which supports C++11. Both GCC 4.8 and Clang 3.4 meet this requirement.

First install the dependencies.

On a Debian or Ubuntu system, this can be done with:

sudo apt-get install make cmake g++ libboost-dev libboost-system-dev \
  libboost-filesystem-dev libexpat1-dev zlib1g-dev \
  libbz2-dev libpq-dev libgeos-dev libgeos++-dev libproj-dev lua5.2 \

To on a Fedora system, use

sudo yum install cmake gcc-c++ boost-devel expat-devel zlib-devel bzip2-devel \
  postgresql-devel geos-devel proj-devel proj-epsg lua-devel

On RedHat / CentOS first run sudo yum install epel-release then install dependencies like on Fedora.

On a FreeBSD system, use

pkg install devel/cmake devel/boost-libs textproc/expat2 \
  databases/postgresql94-client graphics/geos graphics/proj lang/lua52

Once dependencies are installed, use CMake to build the Makefiles in a separate folder

mkdir build && cd build
cmake ..

If some installed dependencies are not found by CMake, more options may need to be set. Typically, setting CMAKE_PREFIX_PATH to a list of appropriate paths is sufficient.

When the Makefiles have been successfully built, compile with


The compiled files can be installed with

sudo make install

By default, the Release build with debug info is created and no tests are compiled. You can change that behavior by using additional options like following:

cmake .. -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Debug -DBUILD_TESTS=ON


Osm2pgsql has one program, the executable itself, which has 42 command line options.

Before loading into a database, the database must be created and the PostGIS and optionally hstore extensions must be loaded. A full guide to PostgreSQL setup is beyond the scope of this readme, but with reasonably recent versions of PostgreSQL and PostGIS this can be done with

createdb gis
psql -d gis -c 'CREATE EXTENSION postgis; CREATE EXTENSION hstore;'

A basic invocation to load the data into the database gis for rendering would be

osm2pgsql --create --database gis data.osm.pbf

This will load the data from data.osm.pbf into the planet_osm_point, planet_osm_line, planet_osm_roads, and planet_osm_polygon tables.

When importing a large amount of data such as the complete planet, a typical command line would be

osm2pgsql -c -d gis --slim -C <cache size> \
  --flat-nodes <flat nodes> planet-latest.osm.pbf


  • <cache size> is 24000 on machines with 32GiB or more RAM or about 75% of memory in MiB on machines with less
  • <flat nodes> is a location where a 24GiB file can be saved.

The databases from either of these commands can be used immediately by Mapnik for rendering maps with standard tools like renderd/mod_tile, TileMill, Nik4, among others. It can also be used for spatial analysis or shapefile exports.

Additional documentation is available on writing command lines.

Alternate backends

In addition to the standard pgsql backend designed for rendering there is also the gazetteer database for geocoding, principally with Nominatim, and the null backend for testing. For flexibility a new multi backend is also avialable which allows the configuration of custom postgres tables instead of those provided in the pgsql backend.

Any questions should be directed at the osm dev list


We welcome contributions to osm2pgsql. If you would like to report an issue, please use the issue tracker on GitHub.

More information can be found in

General queries can be sent to the tile-serving@ or dev@ mailing lists.

Something went wrong with that request. Please try again.