Sign inSign up

boro/bird-announce

By boro

•Updated over 7 years ago

Quick & Easy BIRD container to BGP announce IPv4 & IPv6 Blocks. Configure via environment variables.

Image
1

2.8K

boro/bird-announce repository overview

⁠Dockerized BIRD Internet Routing Daemon

Docker Build Status Docker Automated build MicroBadger Size

Docker Pulls Docker Stars

More information on BIRD: http://bird.network.cz⁠

This container is for setting up quick and easy BIRD container to BGP announce an IPv4 and/or IPv6 Block. It's configured via the environment variables below.

⁠Requirements to run Container

  • Run in Privileged mode
  • Network mode: Host

⁠Environment Variables

All of these variables are required to start

⁠Common (shared between IPv4 and IPv6)
Environment VariableDescriptionExample Value
ROUTER_IDChange this into your BIRD router ID. It's a world-wide unique identification # of this router/server, usually one of public IPv4 addresses.123.123.123.1
PASSWORDYour BGP Session Passwordsecretpassword
MULTIHOPNumber of muliihop sessions2
PEER_ASNYour Peering Partner's AS Number222222
⁠IPv4 Specific
Environment VariableDescriptionExample Value
ENABLE_BIRDEnable the BIRD IPv4 Daemontrue
CONFIG_BIRDGenerate BIRD config on boot using the ENV Vars (NOTE: this will overwrite any volume mounted config file)true
ROUTER_IPV4Your Router's IPv4 address123.123.123.1
PEER_IPV4Your Peering Partner's BGP Router IPv4 address3.3.3.3
ANNOUNCE_IPV4Your IPv4 block (or multiple blocks separated by a space) you want to announce2.2.2.0/24 or 2.2.2.0/24 2.2.2.1/32
⁠IPv6 Specific
Environment VariableDescriptionExample Value
ENABLE_BIRD6Enable the BIRD IPv6 Daemontrue
CONFIG_BIRDGenerate BIRD6 config on boot using the ENV Vars (NOTE: this will overwrite any volume mounted config file)true
ROUTER_IPV6Your Router's IPv6 address2001:100:af00c:88::2
PEER_IPV6Your Peering Partner's BGP Router IPv6 address2001:a50:9f01c:a288::1
ANNOUNCE_IPV6Your IPv6 block (or multiple blocks separated by a space) that you want to announce.2f01:a8f1:1200::/48 or 2f01:a8f1:1200::/48 2f01:a8f1:1201::/48

⁠Useful commands to run inside the container

Show Routes announced via BGP:

  • birdc show route
  • birdc6 show route

Show BGP Status for only the bgp announced (ba) block:

  • birdc show proto ba
  • birdc6 show proto ba

Show BGP Status for everything:

  • birdc show proto all
  • birdc6 show proto all

⁠Contribute

Pull Requests are always welcome. Let's connect!

Tag summary

Content type

Image

Digest

Size

104.6 MB

Last updated

over 7 years ago

docker pull boro/bird-announce