Linux Build Server for Visual Studio Online (VSTS/VSO)

Setting up a Linux build server for VSTS is not as straightforward as it first seems. Below are my notes on setting one up...


Official docs on pre-reqs:

Install the VSTS agent on Ubuntu

~/$ wget
~/$ mkdir vstsagent && cd vstsagent
~/vstsagent$ tar zxvf ~/vsts-agent-osx.10.11-x64-2.111.1.tar.gz

Service configuration

Running currently fails with: Failed to initialize CoreCLR, HRESULT: 0x80131500

This is due to compatibility issues with the icu library v55 on 16.04.
To install v52 run the following...

sudo dpkg -i libicu52_52.1-8ubuntu0.2_amd64.deb  

Now you can continue with the documented steps...

run the configuration tool

~/vstsagent$ ./

You will be asked for the following...

Replace myhost with your VSTS instance...


PAT (Personal access token): can be found in your account security section

The agent should be configured to run as a service...

Known issues

PATH updates

If you ever update PATH this will not automatically be reflected in VSO agent metadata. The workaround is to run run the following...

# update the vso PATH metadata
# restart the vso agent service
~/vstsagent/ stop
~/vstsagent/ start

Guy Harwood

Read more posts by this author.