# Install osmosis with Homebrew, apt, MacPorts

Command-line OpenStreetMap data processor. Version 0.49.2 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:osmosis
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install osmosis
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install osmosis
```

  Evidence: MacPorts ports tree: java/osmosis/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Debian apt (92%):

```sh
sudo apt install osmosis
```

  Evidence: Debian stable package indexes: osmosis from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

## Package facts

- **Package key:** brew:osmosis
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/osmosis>
- **Version:** 0.49.2
- **Source summary:** Command-line OpenStreetMap data processor
- **Homepage:** <https://wiki.openstreetmap.org/wiki/Osmosis>
- **Repository:** <https://github.com/openstreetmap/osmosis>
- **Upstream docs:** <https://github.com/openstreetmap/osmosis#readme>
- **License:** LicenseRef-Homebrew-public-domain
- **Source archive:** <https://github.com/openstreetmap/osmosis/releases/download/0.49.2/osmosis-0.49.2.tar>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- osmosis (cli)
- osmosis (alias)

## Dependencies

- openjdk

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.49.2
- Local data: ok
- Upstream repository: https://github.com/openstreetmap/osmosis
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

Osmosis is a Java command-line application for processing OpenStreetMap data through pluggable pipeline components. It can read and write files and databases, derive and apply changesets, sort datasets, and extract geographic subsets.

### Project history

Osmosis was built around a component pipeline model: tasks for reading, writing, filtering, sorting, database access, replication, and change handling can be chained to form larger data flows. The repository and wiki both describe this as the core design choice, allowing new tasks to be added without rewriting common file and database handling.

The project is closely associated with Brett Henderson in the OSM community. The build metadata lists Brett Henderson as a developer, and a 2020 osmosis-dev message from Michal Migurski describes picking up light Osmosis maintenance from Brett Henderson.

### Adoption history

Osmosis was a central OSM data plumbing tool during the period when planet dumps, database snapshots, replication streams, and regional extracts needed a common Java-based processor. The OpenStreetMap wiki lists workflows such as generating planet dumps from a database, loading dumps into a database, producing changesets from history tables, applying changesets, comparing planet files, sorting dumps, and extracting data by bounding box or polygon.

Development later shifted into light maintenance. The GitHub README says active development stopped in 2018 and describes periodic pull-request acceptance and minor releases; the OpenStreetMap wiki likewise points users toward Osmium as a recommended alternative while preserving Osmosis documentation for workflows that still depend on it.

### How it is used

Developers use Osmosis by composing ordered command-line tasks, such as reading a PBF or XML file, applying a tag filter, adding referenced nodes, and writing the result. Its detailed usage documentation is large because each task exposes its own options, and argument order is part of the pipeline semantics.

Osmosis is also used in replication and database workflows where OSM change files and API database schemas matter. The 2020 maintenance note specifically mentions a release motivated by an API database schema change, which illustrates its role at the boundary between OSM files and OSM infrastructure.

### Why package nerds care

Osmosis matters as a long-lived Java package in a tooling ecosystem that also contains small C utilities and modern C++ libraries. It shows how early OSM infrastructure favored chainable, extensible data processors before lighter compiled tools absorbed many routine file-processing jobs.

### Timeline

- The 0.35 release was the last release to support OSM API 0.5 data. The project README records the 2018 move away from active development. In March 2020, Michal Migurski announced light maintenance work beginning with a 0.47.1 release. GitHub lists 0.49.2 as a December 3, 2023 release.

### Related projects

- Osmium is the recommended alternative named by the OSM wiki for many workflows. osmfilter and osmconvert provide smaller compiled alternatives for filtering and conversion. OSMembrane is documented as a frontend for Osmosis usage.

### Sources

- <https://formulae.brew.sh/formula/osmosis>
- <https://github.com/openstreetmap/osmosis>
- <https://lists.openstreetmap.org/pipermail/osmosis-dev/2020-March/001861.html>
- <https://wiki.openstreetmap.org/wiki/Osmosis>
- <https://wiki.openstreetmap.org/wiki/Osmosis/Detailed_Usage>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** osmosis
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Debian apt - osmosis - 0.49.2-2: normalized package name match | Debian stable package indexes: osmosis from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Command line OpenStreetMap data processor | https://wiki.openstreetmap.org/wiki/Osmosis
- Ubuntu apt - osmosis - 0.49.2-2: normalized package name match | Ubuntu 24.04 LTS package indexes: osmosis from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Command line OpenStreetMap data processor | https://wiki.openstreetmap.org/wiki/Osmosis
- MacPorts - osmosis: normalized package name match | MacPorts ports tree: java/osmosis/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [openjdk](https://www.automicvault.com/pkg/brew/openjdk/) - Runtime dependency declared by Homebrew.
- [imposm3](https://www.automicvault.com/pkg/brew/imposm3/) - Shares av.db curated category or tags: cli, data, geospatial, openstreetmap.
- [osmium-tool](https://www.automicvault.com/pkg/brew/osmium-tool/) - Shares av.db curated category or tags: cli, data, data-processing, geospatial, openstreetmap.
- [geoserver](https://www.automicvault.com/pkg/brew/geoserver/) - Shares av.db curated category or tags: cli, data, geospatial, java.
- [osm-pbf](https://www.automicvault.com/pkg/brew/osm-pbf/) - Shares av.db curated category or tags: cli, data, geospatial, openstreetmap.
- [osmcoastline](https://www.automicvault.com/pkg/brew/osmcoastline/) - Shares av.db curated category or tags: cli, data, geospatial, openstreetmap.
- [osmfilter](https://www.automicvault.com/pkg/brew/osmfilter/) - Shares av.db curated category or tags: cli, data, geospatial, openstreetmap.
- [pdal](https://www.automicvault.com/pkg/brew/pdal/) - Shares av.db curated category or tags: cli, data, data-processing, geospatial.
- [gdal](https://www.automicvault.com/pkg/brew/gdal/) - Shares av.db curated category or tags: cli, data, geospatial.

## Combined YAML source

View the package source record on GitHub. [combined/osmosis.yml](https://github.com/automic-vault/db/blob/main/combined/osmosis.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
