Switch branches/tags
Find file Copy path
4c86924 Apr 8, 2018
@bryanmacfarlane @TingluoHuang @jamesmontemagno
61 lines (41 sloc) 1.73 KB

osx OSX System Prerequisites

OSX Version

Agent version 2.125.0 or above (.Net Core 2.x)

  • macOS 10.12 "Sierra" and later versions

.Net Core 2.x doesn't has any extra prerequisites

Agent version 2.124.0 or below (.Net Core 1.x)

  • macOS 10.12 "Sierra"
  • macOS 10.11 "El Capitan"
  • macOS 10.10 "Yosemite"

.Net Core 1.x requires update OpenSSL - issue 110

From Net Core Instructions

In order to use .NET Core, we first need the latest version of OpenSSL. The easiest way to get this is from Homebrew. After installing brew, do the following:

brew update
brew install openssl
# Ensure folder exists on machine
mkdir -p /usr/local/lib/
ln -s /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib /usr/local/lib/
ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/

This was a recent change from brew. Issue here


If you use git, git >= 2.9.0 is a pre-requisite for OSX agents.

We recommend using home brew to install

$ brew update
$ brew install git
==> Downloading
(restart terminal)
$ git --version
git version 2.9.0
$ which git
$ ls -la /usr/local/bin/git
... /usr/local/bin/git -> ../Cellar/git/2.9.0/bin/git

Optionally Java if TfsVc

The agent distributes team explorer everywhere.

But, if you are using TfsVc, install Oracle Java 1.8+ as TEE uses Java.

More .Net Core Prerequisites Information