# Install iproute2mac with Homebrew, MacPorts, Nix, apk, winget

CLI wrapper for basic network utilities on macOS - ip command. Version 1.7.4 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:iproute2mac
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install iproute2mac
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install iproute2mac
```

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

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#iproute2mac
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ip/iproute2mac/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- apk (92%):

```sh
sudo apk add bridge
```

  Evidence: Alpine Linux edge package indexes: bridge from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz

### Windows

- winget (92%):

```sh
winget install --id Geomitron.Bridge -e
```

  Evidence: Windows Package Manager source index: Geomitron.Bridge from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:iproute2mac
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/iproute2mac>
- **Version:** 1.7.4
- **Source summary:** CLI wrapper for basic network utilities on macOS - ip command
- **Homepage:** <https://github.com/brona/iproute2mac>
- **Repository:** <https://github.com/brona/iproute2mac>
- **Upstream docs:** <https://github.com/brona/iproute2mac#readme>
- **License:** MIT
- **Source archive:** <https://github.com/brona/iproute2mac/releases/download/v1.7.4/iproute2mac-1.7.4.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- bridge (cli)
- ip (cli)
- ss (cli)
- bridge (alias)
- ip (alias)
- ss (alias)

## Dependencies

- python@3.14

## Install behavior

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

## Freshness

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

iproute2mac is a macOS command-line compatibility wrapper that provides ip, bridge, and ss commands inspired by Linux iproute2 for administrators who move between Linux and macOS.

### Project history

The project README describes a deliberately limited wrapper for basic macOS network utilities, not a complete reimplementation of Linux iproute2. Its goal is to make routine macOS network configuration and debugging easier for administrators already fluent in Linux-style ip commands.

The changelog shows an incremental compatibility project: early 1.0.x releases fixed ip address and neighbor handling; v1.1.0 added ip route get source-address output and marked acceptance into Homebrew master; v1.3.0 migrated to Python 3; v1.5.0 added JSON output and bridge; and v1.7.0 added ss plus brief/oneline output options.

### Adoption history

iproute2mac found its audience in the macOS admin and developer niche where muscle memory from Linux is valuable but macOS networking remains built on ifconfig, netstat, route, ndp, arp, and networksetup. The README explicitly sends advanced users back to those native tools for deeper work.

Distribution through Homebrew is part of the project's identity: the README lists Homebrew as the preferred installation path and notes the formula is maintained by the project author. It also documents MacPorts and NixOS packaging.

### How it is used

The command set covers common inspection and light configuration tasks: ip link, ip addr, ip route, ip neigh, bridge link, and ss, with selected support for JSON, color, brief, and oneline output. Its value is ergonomic consistency, not total kernel feature parity.

Because macOS lacks Linux netlink and tc semantics, iproute2mac translates familiar syntax onto native macOS tools and data sources. The README warns that functionality and output compatibility are limited, which is the right contract for a portability shim.

### Why package nerds care

iproute2mac is interesting because it packages muscle memory. It is a small Python wrapper that turns a platform mismatch into a command-line convenience, while keeping the boundary visible enough that serious macOS networking work still goes through native tools.

### Timeline

- v1.0.x: Early releases fix ip addr, ip neigh, help, and versioning behavior.
- v1.1.0: Project is accepted into Homebrew master and no longer requires a tap.
- v1.3.0: Codebase migrates to Python 3.
- v1.5.0: JSON output and bridge command support are added.
- v1.7.0: ss command and brief/oneline output options are added.

### Related projects

- Linux iproute2 is the direct inspiration and compatibility target.
- macOS ifconfig, netstat, ndp, arp, route, and networksetup are the native tools beneath or beside the wrapper.
- MacPorts and NixOS provide alternate package-manager routes alongside Homebrew.

### Sources

- Homebrew formula metadata supplies package-manager presence, formula description, macOS requirement, and adoption signals.
- The GitHub README supplies project goal, limitations, command coverage, installation paths, changelog, and related native macOS tools.


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

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

## Other Package-Manager Records

- Nix - iproute2mac: normalized package name match | nixpkgs package indexes: pkgs/by-name/ip/iproute2mac/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- MacPorts - iproute2mac: normalized package name match | MacPorts ports tree: net/iproute2mac/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- apk - bridge - 1.5-r5: installed executable or alias match | Alpine Linux edge package indexes: bridge from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Scripts for configuring network bridge interfaces | https://wiki.alpinelinux.org/wiki/Bridge
- winget - Geomitron.Bridge: installed executable or alias match | Windows Package Manager source index: Geomitron.Bridge from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [iproute2](https://www.automicvault.com/pkg/brew/iproute2/) - Shares av.db curated category or tags: cli, networking, routing.
- [zebra](https://www.automicvault.com/pkg/brew/zebra/) - Shares av.db curated category or tags: cli, networking, routing.
- [babeld](https://www.automicvault.com/pkg/brew/babeld/) - Shares av.db curated category or tags: cli, networking, routing.
- [irrtoolset](https://www.automicvault.com/pkg/brew/irrtoolset/) - Shares av.db curated category or tags: cli, networking, routing.
- [olsrd](https://www.automicvault.com/pkg/brew/olsrd/) - Shares av.db curated category or tags: cli, networking, routing.
- [osrm-backend](https://www.automicvault.com/pkg/brew/osrm-backend/) - Shares av.db curated category or tags: cli, networking, routing.
- [macosvpn](https://www.automicvault.com/pkg/brew/macosvpn/) - Shares av.db curated category or tags: cli, macos, networking.
- [monocle](https://www.automicvault.com/pkg/brew/monocle/) - Shares av.db curated category or tags: cli, networking, routing.
- [gensio](https://www.automicvault.com/pkg/brew/gensio/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, networking, python, python-3-14.
- [mcp-proxy](https://www.automicvault.com/pkg/brew/mcp-proxy/) - Both packages touch the same language runtime or ecosystem. Shared terms: bridge, cli, networking, python, python-3-14.

## Combined YAML source

View the package source record on GitHub. [combined/iproute2mac.yml](https://github.com/automic-vault/db/blob/main/combined/iproute2mac.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
