Mono framework is an alternative framework for running .NET applications on both Windows and Unix-based platforms.
For more information please refer to the Mono official site.
Supported Build Runners
TeamCity supports running .NET builds using NAnt and MSBuild runners under Mono framework as well as under .NET Frameworks. (MSBuild as xbuild in Mono).
Since TeamCity 2017.1 NuGet runners support Linux and macOS when Mono is installed on the agent. Note that only NuGet CLI 3.2+ on Mono 4.4.2+ is supported.
Tests reporting tasks are also supported under Mono.
Mono Platform Detection
When a build agent starts, it detects a Mono installation automatically.
On each platform, Mono detection is compatible with NAnt one. See
NAnt.exe.config for frameworks detection on NAnt.
When Mono is detected automatically on the agent side, the following properties are set:
- Mono — path to the mono executable (Mono JIT)
- MonoVersion — Mono version
- MonoX.Z — set to
- MonoX.Z_x64 — set to
MONO_ROOT/lib/mono/X.Zif exists and Mono architecture is x64
- MonoX.Z_x86 — set to
MONO_ROOT/lib/mono/X.Zif exists and Mono architecture is x86
If the Mono installation cannot be detected automatically (for example, you have installed Mono framework into a custom directory), you can make these properties available to build runners by setting them manually in the agent configuration file.
Automatic detection of Mono framework under Windows has the following specifics:
- The Mono version is read from
- The Frameworks paths are extracted from
- The platform architecture is detected by analyzing
Mac OS X Specifics
- The framework is detected automatically from
- The highest version is selected.
- The frameworks path are extracted from
- The platform architecture is fixed to x86 as Mono official builds support only X86
Custom Linux/Unix Specifics
Automatic detection of Mono framework under Unix has the following specifics:
- Mono version is read from "
pkg-config --modversion mono"
- The frameworks paths are extracted from "
pkg-config --variable=prefix mono" and "
pkg-config --variable=libdir mono"
- The platform architecture is detected by analyzing the
You can force Mono to be detected from a custom location by adding the
PREFIX/bin directory to the beginning of the
PATH and updating
PKG_CONFIG_PATH (described in pkg-config(1)) with