Docker¶

bgpipe is published as a minimal, multi-architecture Docker image at ghcr.io/bgpfix/bgpipe.

Available tags:

latest - latest build from main branch
vX.Y.Z - specific release
vX.Y - latest patch of a minor release

Quick Start¶

# print help
docker run --rm ghcr.io/bgpfix/bgpipe:latest --help

# find RPKI-invalid announcements in RIPE RIS live stream
docker run --rm ghcr.io/bgpfix/bgpipe:latest -go \
    -- ris-live \
    -- rpki --invalid=keep \
    -- grep 'tag[rpki/status] == INVALID'

Reading Files from the Host¶

Mount a host directory to pass MRT files or capture output:

# read a local MRT file and write JSON output to the host
docker run --rm \
    -v /path/to/data:/data \
    ghcr.io/bgpfix/bgpipe:latest \
    -- read /data/updates.mrt \
    -- write /data/output.json

BGP Sessions (Port Forwarding)¶

To run bgpipe as a proxy accessible from the host or other containers, expose port 179:

# transparent proxy: host:1790 → bgpipe → 192.0.2.1:179
docker run --rm \
    -p 1790:179 \
    ghcr.io/bgpfix/bgpipe:latest \
    -- listen :179 \
    -- connect --wait "listen" 192.0.2.1

--wait listen tells the connect stage to wait until listen has accepted a connection before dialling out. This ensures the two halves of the proxy session are always synchronized.

Docker Compose Examples¶

Docker Compose lets you define multi-container setups in a single YAML file. To run any example below, save it as compose.yml in a new directory and run:

docker compose up       # start (Ctrl+C to stop)
docker compose down     # clean up

RIS Live Monitoring¶

The simplest example to try — no files or routers needed. Streams live BGP from RIPE RIS Live and prints matching routes to stdout:

services:
  bgpipe:
    image: ghcr.io/bgpfix/bgpipe:latest
    command: >-
      -g
      -- ris-live
      -- grep 'prefix ~ 8.0.0.0/8'
      -- stdout

MRT to JSON¶

Fetch a live MRT file from RIPE RIS and write it as JSON. The read stage handles URLs and gzip decompression automatically; the output JSON lands on the host via a volume mount:

services:
  bgpipe:
    image: ghcr.io/bgpfix/bgpipe:latest
    volumes:
      - ./data:/data
    command: >-
      -- read https://data.ris.ripe.net/rrc01/2025.11/updates.20251107.2300.gz
      -- write /data/output.json

mkdir data
docker compose up
# output.json appears in ./data/ when done

Building Locally¶

The Dockerfile auto-detects the target platform, so a plain docker build produces the right image for your machine — no flags needed:

git clone https://github.com/bgpfix/bgpipe
cd bgpipe
docker build -t bgpipe .
docker run --rm bgpipe --help

To explicitly target a different platform:

docker build --platform linux/arm64 -t bgpipe .