Files
runner/docs/start/envlinux.md
2025-08-30 04:29:59 +00:00

1.9 KiB

Linux Linux System Prerequisites

Supported Distributions and Versions

Please see "Supported architectures and operating systems for self-hosted runners."

Install .Net Core 3.x Linux Dependencies

The ./config.sh will check .Net Core 3.x dependencies during runner configuration.
You might see something like this which indicate a dependency's missing.

./config.sh
    libunwind.so.8 => not found
    libunwind-x86_64.so.8 => not found
Dependencies is missing for Dotnet Core 6.0
Execute ./bin/installdependencies.sh to install any missing Dotnet Core 6.0 dependencies.

You can easily correct the problem by executing ./bin/installdependencies.sh.
The installdependencies.sh script should install all required dependencies on all supported Linux versions

Note: The installdependencies.sh script will try to use the default package management mechanism on your Linux flavor (ex. yum/apt-get/apt). For Fedora-based systems, the script automatically handles lttng-ust version compatibility by creating symlinks when needed (e.g., Fedora 41 ships with liblttng-ust.so.1 but the runner needs liblttng-ust.so.0).

Full dependencies list

Debian based OS (Debian, Ubuntu, Linux Mint)

  • liblttng-ust1 or liblttng-ust0
  • libkrb5-3
  • zlib1g
  • libssl1.1, libssl1.0.2 or libssl1.0.0
  • libicu63, libicu60, libicu57 or libicu55

Fedora based OS (Fedora, Red Hat Enterprise Linux, CentOS, Oracle Linux 7)

  • lttng-ust (the installdependencies.sh script will automatically handle version compatibility for newer Fedora versions)
  • openssl-libs
  • krb5-libs
  • zlib
  • libicu

SUSE based OS (OpenSUSE, SUSE Enterprise)

  • lttng-ust
  • libopenssl1_1
  • krb5
  • zlib
  • libicu60_2

More .Net Core Prerequisites Information