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://github.com/openstreetmap/osm2pgsql.git
Osm2pgsql uses the GNU Build System to configure and build itself and requires
- Protocol Buffers
- PostgreSQL client libraries
- Lua (Optional, used for Lua tag transforms)
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.
To install on a Debian or Ubuntu system, first install the prerequisites:
sudo apt-get install autoconf automake libtool make g++ pkg-config libboost-dev \ libboost-system-dev libboost-filesystem-dev libboost-thread-dev libexpat1-dev \ libgeos-dev libgeos++-dev libpq-dev libbz2-dev libproj-dev zlib1g-dev \ protobuf-compiler libprotobuf-dev lua5.2 liblua5.2-dev
To install on a Fedora system, use
sudo yum install gcc-c++ automake libtool pkgconfig boost-devel \ expat-devel bzip2-devel postgresql-devel geos-devel proj-devel \ lua-devel protobuf-devel protobuf-lite-devel
To install on a FreeBSD system, use
pkg install devel/git devel/autoconf devel/automake devel/gmake devel/libtool \ textproc/expat2 graphics/geos graphics/proj databases/postgresql94-client \ devel/boost-libs devel/protobuf lang/lua52 devel/pkgconf
Then you should be able to bootstrap the build system:
And then run the standard GNU build install:
./configure && make && make install
./configure --help for more options on how to control the build
On FreeBSD instead bootstrap and then run
LUA_LIB=`pkg-config --libs lua-5.2` ./configure && gmake && gmake install
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
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.
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 http://wiki.openstreetmap.org/index.php/Mailing_lists
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 CONTRIBUTING.md.
General queries can be sent to the tile-serving@ or dev@ mailing lists.