Below versions of Doxygen are available in respective distributions at the time of creation of these build instructions:

• RHEL 8.10 has 1.8.14
• RHEL (9.4, 9.6, 9.7) have 1.9.1
• RHEL (10.0, 10.1) have 1.13.2
• SLES 15 SP7 has 1.8.14
• SLES 16 has 1.14.0
• Ubuntu 22.04 has 1.9.1
• Ubuntu (24.04, 25.10) have 1.9.8

The instructions provided below specify the steps to build Doxygen version 1.16.1 on Linux on IBM Z for

• RHEL (8.10, 9.4, 9.6, 9.7, 10.0, 10.1)
• SLES (15 SP7, 16)
• Ubuntu (22.04, 24.04, 25.10)

General Notes:

• When following the steps below please use a standard permission user unless otherwise specified.

• A directory /<source_root>/ will be referred to in these instructions, this is a temporary writable directory anywhere you'd like to place it.

If you want to build doxygen using manual steps, go to STEP 1.2.

Use the following commands to build doxygen using the build script. Please make sure you have wget installed.

wget -q https://raw.githubusercontent.com/linux-on-ibm-z/scripts/master/Doxygen/1.16.1/build_doxygen.sh

# Build doxygen
bash build_doxygen.sh [Provide -t option for executing build with tests]

In case of error, check logs for more details or go to STEP 1.2 to follow manual build steps.

export SOURCE_ROOT=/<source_root>/

• RHEL (8.10)

  sudo yum install -y gcc gcc-c++ python3 cmake bison qt5-devel diffutils unzip texlive

• RHEL (9.4, 9.6, 9.7)

  sudo yum install -y gcc gcc-c++ python3 flex cmake bison qt5-devel diffutils unzip texlive

• RHEL (10.0, 10.1)

  sudo yum install -y gcc gcc-c++ flex cmake bison qt5-qtbase-devel qt5-qtsvg-devel diffutils unzip texlive

• SLES (15 SP7, 16)

  sudo zypper install -y gcc gcc-c++ flex cmake bison libqt5-qtsvg-devel libqt5-qtbase-devel libxml2-devel unzip texlive-bibtex-bin
  
  # only on SLES 15 SP7
  sudo zypper install -y gcc14 gcc14-c++
  sudo update-alternatives --install /usr/bin/cc cc /usr/bin/gcc-14 14
  sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-14 14
  sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-14 14
  sudo update-alternatives --install /usr/bin/c++ c++ /usr/bin/g++-14 14

• Ubuntu (22.04, 24.04, 25.10)

  sudo apt-get update
  sudo apt-get install -y unzip cmake flex bison build-essential libqt5svg5-dev qtbase5-dev libxml2-utils texlive-bibtex-extra

wget https://github.com/westes/flex/releases/download/v2.6.4/flex-2.6.4.tar.gz
tar xf flex-2.6.4.tar.gz
cd flex-2.6.4
./configure --prefix=/usr/
make -j$(nproc)
sudo make install

cd $SOURCE_ROOT
git clone -b Release_1_16_1 https://github.com/doxygen/doxygen.git

cd $SOURCE_ROOT/doxygen
mkdir build

cd $SOURCE_ROOT/doxygen/build
cmake -G "Unix Makefiles" -Dbuild_doc=YES -Dbuild_wizard=YES ..
make -j$(nproc)

• Download manual and install

  wget https://github.com/doxygen/doxygen/releases/download/Release_1_16_1/doxygen_manual-1.16.1.pdf.zip
  unzip doxygen_manual-1.16.1.pdf.zip
  mkdir -p latex
  mv doxygen_manual-1.16.1.pdf latex/doxygen_manual.pdf
  sudo make install

cd $SOURCE_ROOT/doxygen/build
sudo make tests

export PATH=/usr/local/bin:$PATH
doxygen -v

• https://github.com/doxygen/doxygen