bgpgg

A BGP router written in Rust, designed for speed and observability.

Get Started

Download the latest release for your platform.

# Example for v0.2.0 on Linux x86_64
curl -LO https://github.com/bgpgg-org/bgpgg/releases/download/v0.2.0/bgpgg-v0.2.0-x86_64-linux.tar.gz
tar xzf bgpgg-v0.2.0-x86_64-linux.tar.gz

Create a config file:

# rogg.conf
service bgp {
  asn 65000
  router-id 1.1.1.1
  listen-addr 0.0.0.0:17900

  peer 192.168.1.1 {
    remote-as 65001
    port 17900
  }
}

Start the daemon:

./bgpggd --config rogg.conf

Use ggsh (gg shell) to manage it:

$ ggsh
ggsh> show bgp summary
BGP router listening on 0.0.0.0:17900
RIB entries 1200, 2400 paths
Peers 2, 2 established

Neighbor             AS            MsgRcvd  MsgSent  State/PfxRcd
10.0.0.1             65001            4821     3200  Established

ggsh> show bgp routes
> 10.0.0.0/24
    via 10.0.0.1  lp 100  path 65001  [best]

ggsh> exit

For scripting: ggsh show bgp summary

Build from Source

make
./target/release/bgpggd --config rogg.conf
./target/release/ggsh

Docker

curl -LO https://raw.githubusercontent.com/bgpgg-org/bgpgg/master/docker/docker-compose.yml
docker compose up -d
docker exec bgpgg1 ggsh show bgp summary