Skip to main content

Update Self-hosted Runner

When a new version of self-hosted runner is released, you can update runner with below steps.

1. Update Runner

Download and extract the latest self-hosted runner package.

curl -o appcircle-runner-osx-x64-1.3.6.zip -L https://cdn.appcircle.io/self-hosted/runner/appcircle-runner-osx-x64-1.3.6.zip

Extract self-hosted runner package.

unzip -o -u appcircle-runner-osx-x64-1.3.6.zip

Change directory into extracted appcircle-runner folder for following steps.

cd appcircle-runner

2. Reinstall Service

Although we change self-hosted runner files with above update step, we need to restart runner service in order to activate latest updates.

Some updates may also contain systemd or launchd service updates. For this reason, on every update, reinstalling service is suggested.

Reinstalling service also contains runner restart operations and doesn't affect self-hosted runner logs or produced artifacts.

In order to reinstall systemd or launchd service, first uninstall and then install service with below commands.

./ac-runner service -c uninstall
./ac-runner service -c install
info

When you complete update successfully, you will see updated version in "Self-hosted Runners" list in here.

./ac-runner --version