Installation

Installing on Linux

There are packages of osm2pgsql available for many different Linux distributions. Some of them are quite old, though, and have known bugs. If the current release is not available for your distribution, consider installing the current release from source.

Installing on Ubuntu

For Ubuntu installation is usually as simple as

apt install osm2pgsql

Installing on Debian

For Debian installation is usually as simple as

apt install osm2pgsql

If you are using Debian Stable, we recommend using the packages from backports. Debian maintainers are really good at keeping these up-to-date.

Installing on Fedora

Fedora has packages of osm2pgsql available. Install with

dnf install osm2pgsql

Installing on openSUSE

First add the “Geo” package repository (adapt URL to the openSUSE version you use):

zypper ar https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.2/ "Geo"
zypper refresh

Then install osm2pgsql:

zypper install osm2pgsql

Installing on Arch Linux

Build the osm2pgsql-git package from the AUR. (Download the tarball and compile/install with makepkg, or use an AUR helper such as yaourt.)

Installing from Source / Git

If you can’t use the packaged version of osm2pgsql for your distribution, you can always install from source.

• To install the latest release, download the latest release as tar.gz or zip file and unpack it.
• To install a version from git, get it with git clone https://github.com/osm2pgsql-dev/osm2pgsql.

See the Building section in the README.md for a list of dependencies and build instructions.

Installing on Windows

Using prebuilt binaries

You can download prebuilt binaries. Unpack the ZIP file and you can immediately use osm2pgsql.

Compiling from source

For native Windows compilation you need a C++17-compatible compiler. Follow the usual steps for compiling CMake projects.

Installing on macOS

Osm2pgsql is available on Homebrew. Install with

brew install osm2pgsql

Installing on FreeBSD

Osm2pgsql is available in FreeBSD Ports. Install with:

pkg install converters/osm2pgsql

Upgrading an Existing Installation

Usually you can upgrade an existing installation of osm2pgsql to a new version without worries. But sometimes the database format or something like it changes and you have to re-import the OSM data, create a new index or so. Please read the release information carefully. There is also an appendix in the manual with upgrading information.