Skip to content

Build Custom Docker Image

Jump to bottom
Tommaso Caiazzi edited this page Apr 7, 2026 · 1 revision

Build a Custom Docker Image

All standard images corresponding to Dockerfiles in Docker-Images are already published on Docker Hub ( kathara/*): https://hub.docker.com/u/kathara.

This page only covers building custom local images (for example, custom versions or local variants) that are not pushed to Docker Hub.

Prerequisites

  • Docker installed and running
  • Git installed

1) Clone Docker-Images

git clone git@github.com:KatharaFramework/Docker-Images.git
cd Docker-Images

2) Build a Custom Software Version

Use this procedure when you need a local image for a software version that is not provided as a ready-made Dockerfile in the repository.

BIRD

  1. For BIRD, copy an existing version file as a custom starting point:
cp bird2/Dockerfile-2.15.1 bird2/Dockerfile-2.17.1-custom
  1. Edit bird2/Dockerfile-2.17.1-custom and update the pinned package in the apt install line:
# before
bird2=2.15.1-cznic.1~jammy

# after (example target version)
bird2=2.17.1-cznic.1~jammy

Note: You can check available versions of BIRD (1/2/3) packages on the official Launchpad repository.

  1. Build the custom image locally:
docker build -f bird2/Dockerfile-2.17.1-custom -t kathara/bird2:2.17.1-custom bird2
  1. Verify the local image:
docker images | grep "kathara/bird2"

OpenBGPD

For OpenBGPD package versions, refer to Debian Tracker. If you need a custom local OpenBGPD image, use the same copy/edit/build flow with the openbgpd Dockerfile and a custom local tag.

3) Use It in the Digital Twin

In the dashboard route server settings, set Docker Image to your local tag (for example, kathara/bird2:2.17.1-custom).

Need help?

If you need help with custom images, please contact us or directly open an issue on the Docker-Images repository.

Clone this wiki locally