Skip to content

Requirements for self hosted runners

Shivam Mathur edited this page May 9, 2020 · 19 revisions

Before you setup your self-hosted runner, make sure the following requirements are met on your host system.

Linux

  • Ubuntu 18.04 (bionic) and Ubuntu 16.04 (xenial) are supported.
  • If using docker you can use shivammathur/node docker images as host.
  • The action needs sudo, so make sure that is installed.
apt-get update
apt-get install sudo
  • The runner needs a user account having password-less sudo access, otherwise you would have to enter the password on each run.
# Add user X to the sudo group and enable password-less sudo for all sudoers.
usermod -a -G sudo X
echo "%sudo ALL = (ALL) NOPASSWD: ALL" | sudo tee -a /etc/sudoers

Windows

  • Windows 7 and above are supported.
  • The runner needs a user account which has Administrative privileges.
:: In cmd type this and check that it lists Administrators in Local Group Memberships
net user "%username%" | findstr "Local Group Memberships"
  • Powershell Core 6.0 or newer needs to be installed and added to PATH environment variable.
# Setup Latest Powershell Core using windows Powershell.
Invoke-Expression "& { $(Invoke-RestMethod 'https://aka.ms/install-powershell.ps1') } -AddToPath"

MacOS

  • macOS X Catalina 10.15 is supported.
  • The runner needs a user account having password-less sudo access, otherwise you would have to enter the password on each run.
# Enable password-less sudo
echo "%admin ALL = (ALL) NOPASSWD: ALL" | sudo tee -a /etc/sudoers