Source code

You can get the most recent source tree by cloning our main git repository:

git clone https://github.com/xrootd/xrootd.git

Release Tarballs

Older releases can be found at our archive page at https://xrootd.org/archive.html#past-releases.

Official RPM Repositories

We build RPMs for RHEL-based distributions and make them available through dnf/yum. The repo files are available at:

• RHEL RPMs: https://xrootd.web.cern.ch/xrootd.repo
• Fedora RPMs: https://xrootd.web.cern.ch/xrootd-fedora.repo

For example, to use the official repository on Alma 9, one can add the repository with dnf:

dnf config-manager --add-repo https://xrootd.web.cern.ch/xrootd.repo

On Fedora, use the command below instead:

dnf config-manager addrepo --from-repofile=https://xrootd.web.cern.ch/xrootd-fedora.repo

or simply use curl:

curl -L https://xrootd.web.cern.ch/xrootd.repo -o /etc/yum.repos.d/xrootd.repo

Each of these repo files define three repositories: xrootd-stable, which contains stable releases, xrootd-testing, which may contain unreleased versions for testing, and xrootd-source, which provides the source RPMs to allow one to download sources and patches for a release and build/rebuild custom RPMs locally. By default, only the main xrootd-stable repository and the xrootd-source repository for the sources are enabled. All RPMs on these repositories are signed with the following GPG key:

• XRootD Developers (RPM Signing Key) xrootd-dev@slac.stanford.edu
• Fingerprint: B3D5 6D10 62CA 39A5 92CD 70EA E07D BF0E FD32 3FF0
• From: https://xrootd.web.cern.ch/repo/RPM-GPG-KEY.txt

You can use rpm to import the key as shown below:

rpm --import https://xrootd.web.cern.ch/repo/RPM-GPG-KEY.txt

Otherwise, just run dnf update -y once after adding the repository, and the key will be added automatically.

Using SRPMs to Build XRootD

Once the official RPM repository is configured, it is possible to download the latest source RPMs and rebuild it locally with yum/dnf as shown below:

dnf install dnf-plugins-core
dnf download --source xrootd
sudo dnf install -y epel-release rpmdevtools
sudo dnf config-manager --set-enabled crb # or powertools on Alma 8
rpmdev-setuptree
sudo dnf builddep -y xrootd-*.src.rpm # the file just downloaded
rpmbuild --rebuild --without tests xrootd-*.src.rpm

Building RPM packages using xrootd.spec

There are two main methods for building RPMs using the xrootd.spec file at the root of the XRootD git repository. If you just would like to build the latest release, the steps are as shown below (using Alma 9 as example):

curl -L https://github.com/xrootd/xrootd/raw/master/xrootd.spec -o xrootd.spec
sudo dnf install -y epel-release rpmdevtools dnf-plugins-core # install pre-requisites
sudo dnf config-manager --set-enabled crb     # enable crb repository by default
rpmdev-setuptree                              # create ~/rpmbuild and subdirectories
sudo dnf builddep -y xrootd.spec              # install XRootD build dependencies
spectool -g -R xrootd.spec                    # download upstream source tarball
rpmbuild -bb --without tests xrootd.spec      # build RPMs
sudo dnf install -y ~/rpmbuild/RPMS/*/*.rpm   # install RPMs

Note that most steps can be performed as a regular user, only installation of dependencies needs to be done as root.

The other method allows to build RPMs for the currently checked out git branch. In this case, we should produce a tarball ourselves, and then use --with git to build:

git clone https://github.com/xrootd/xrootd
cd xrootd
rpmdev-setuptree
git archive --prefix xrootd/ -o $(rpm -E '%{_sourcedir}')/xrootd.tar.gz HEAD
sudo dnf builddep -y xrootd.spec
rpmbuild -bb --with git xrootd.spec
sudo dnf install -y ~/rpmbuild/RPMS/*/*.rpm

This is the method used in the continuous integration system to build RPMs. The versions created when building in this mode are based on the last tag, the number of commits that come after it, and a git hash corresponding to the last commit in the branch.

Official DEB Repositories

We build official DEB packages for Debian and Ubuntu distributions. If you would like to use our repositories to get more recent versions of XRootD on your distribution, please see below how to enable it.

First, the GPG key used to sign the repositories needs to be installed, to allow apt to trust our repository. We sign the DEB packages with the same key used for RPMs. To install it, simply download the public key and place it into /etc/apt/trusted.gpd.d/:

curl -L https://xrootd.web.cern.ch/repo/RPM-GPG-KEY.txt -o /etc/apt/trusted.gpg.d/xrootd.asc

Note that the extension .asc is important here. If you do not use this extension, apt may try to process the key as binary instead of ASCII armored text.

Next, you need to choose the right repository URL and component to use. We provide repositories for Debian 11 (bullseye), Debian 12 (bookworm), and Debian 13 (trixie), as well as Ubuntu 22.04 (jammy), Ubuntu 24.04 (noble), and Ubuntu 26.04 (resolute). We offer two repositories: stable and testing. The stable repository (i.e. the apt component) contains XRootD stable releases and should be the preferred option. The testing repository may contain unreleased development versions of XRootD from git. To setup the repository on Debian 13 using the stable component, you can run

echo "deb https://xrootd.web.cern.ch/debian trixie stable" >> /etc/apt/sources.list.d/xrootd.list

On Ubuntu 26.04, run the following instead

echo "deb https://xrootd.web.cern.ch/ubuntu resolute stable" >> /etc/apt/sources.list.d/xrootd.list

Depending on the distribution, you may need to use the file /etc/apt/sources.list instead of using the directory /etc/apt/sources.list.d. Nevertheless, the line to be added is the same as in the command above.

Once the repository is setup, one can install the packages as usual:

apt update
apt install xrootd-client xrootd-server python3-xrootd

Starting with XRootD 5.7.0, the official repositories also offer a metapackage xrootd which will install both xrootd-client and xrootd-server together.

Continuous Integration Builds

XRootD uses GitHub Actions and GitLab CI for continuous integration. Incremental builds are accessible on each of these platforms at the links below:

• GitHub Actions: https://github.com/xrootd/xrootd/actions
  • DEB: https://github.com/xrootd/xrootd/actions/workflows/DEB.yml
  • RPM: https://github.com/xrootd/xrootd/actions/workflows/RPM.yml
• GitLab CI: https://gitlab.cern.ch/dss/xrootd/pipelines

Build artifacts can be downloaded from the links above for a short period before they expire. If you have a fork of XRootD, the builds to create DEB/RPM packages can also be run on demand. Please see the link below for instructions on how to do that:

https://docs.github.com/en/actions/using-workflows/manually-running-a-workflow

Copyright © SLAC / CERN | Design based on Uncomplicated