2023-09-07 10:48:53 -04:00
## What's Changed
2026-01-09 12:15:39 -05:00
* Fix owner of /home/runner directory by @nikola -jokic in https://github.com/actions/runner/pull/4132
* Update Docker to v29.0.2 and Buildx to v0.30.1 by @github -actions[bot] in https://github.com/actions/runner/pull/4135
* Update workflow around runner docker image. by @TingluoHuang in https://github.com/actions/runner/pull/4133
* Fix regex for validating runner version format by @TingluoHuang in https://github.com/actions/runner/pull/4136
* chore: update Node versions by @github -actions[bot] in https://github.com/actions/runner/pull/4144
* Ensure safe_sleep tries alternative approaches by @TingluoHuang in https://github.com/actions/runner/pull/4146
* Bump actions/github-script from 7 to 8 by @dependabot [bot] in https://github.com/actions/runner/pull/4137
* Bump actions/checkout from 5 to 6 by @dependabot [bot] in https://github.com/actions/runner/pull/4130
* chore: update Node versions by @github -actions[bot] in https://github.com/actions/runner/pull/4149
* Bump docker image to use ubuntu 24.04 by @TingluoHuang in https://github.com/actions/runner/pull/4018
* Add support for case function by @AllanGuigou in https://github.com/actions/runner/pull/4147
* Cleanup feature flag actions_container_action_runner_temp by @ericsciple in https://github.com/actions/runner/pull/4163
* Bump actions/download-artifact from 6 to 7 by @dependabot [bot] in https://github.com/actions/runner/pull/4155
* Bump actions/upload-artifact from 5 to 6 by @dependabot [bot] in https://github.com/actions/runner/pull/4157
* Set ACTIONS_ORCHESTRATION_ID as env to actions. by @TingluoHuang in https://github.com/actions/runner/pull/4178
* Allow hosted VM report job telemetry via .setup_info file. by @TingluoHuang in https://github.com/actions/runner/pull/4186
* Bump typescript from 5.9.2 to 5.9.3 in /src/Misc/expressionFunc/hashFiles by @dependabot [bot] in https://github.com/actions/runner/pull/4184
* Bump Azure.Storage.Blobs from 12.26.0 to 12.27.0 by @dependabot [bot] in https://github.com/actions/runner/pull/4189
2024-11-13 12:20:10 -05:00
2025-07-07 15:19:21 -04:00
## New Contributors
2026-01-09 12:15:39 -05:00
* @AllanGuigou made their first contribution in https://github.com/actions/runner/pull/4147
2025-07-07 15:19:21 -04:00
2026-01-09 12:15:39 -05:00
**Full Changelog ** : https://github.com/actions/runner/compare/v2.330.0...v2.331.0
2021-11-01 11:16:21 -04:00
2024-02-07 15:15:32 -05:00
_Note: Actions Runner follows a progressive release policy, so the latest release might not be available to your enterprise, organization, or repository yet.
To confirm which version of the Actions Runner you should expect, please view the download instructions for your enterprise, organization, or repository.
2023-01-18 10:41:53 -05:00
See https://docs.github.com/en/enterprise-cloud@latest/actions/hosting -your-own-runners/adding-self-hosted-runners_
2019-10-10 00:52:42 -04:00
## Windows x64
2024-05-02 13:44:48 -04:00
2020-04-20 04:11:44 +02:00
We recommend configuring the runner in a root folder of the Windows drive (e.g. "C:\actions-runner"). This will help avoid issues related to service identity folder permissions and long file path restrictions on Windows.
The following snipped needs to be run on `powershell` :
2024-05-02 13:44:48 -04:00
``` powershell
2020-04-20 04:11:44 +02:00
# Create a folder under the drive root
2019-11-19 16:27:36 -05:00
mkdir \ actions-runner ; cd \ actions-runner
2020-04-20 04:11:44 +02:00
# Download the latest runner package
2019-12-18 15:28:36 -05:00
Invoke-WebRequest -Uri https : / / github . com / actions / runner / releases / download / v < RUNNER_VERSION > / actions-runner -win -x64 - < RUNNER_VERSION > . zip -OutFile actions-runner -win -x64 - < RUNNER_VERSION > . zip
2020-04-20 04:11:44 +02:00
# Extract the installer
2021-09-15 07:35:25 -04:00
Add-Type -AssemblyName System . IO . Compression . FileSystem ;
2020-01-29 12:58:09 -05:00
[ System.IO.Compression.ZipFile ] :: ExtractToDirectory ( " $PWD \actions-runner-win-x64-<RUNNER_VERSION>.zip " , " $PWD " )
2019-10-10 00:52:42 -04:00
```
2024-11-13 12:20:10 -05:00
## Windows arm64
2022-09-26 09:20:43 -04:00
We recommend configuring the runner in a root folder of the Windows drive (e.g. "C:\actions-runner"). This will help avoid issues related to service identity folder permissions and long file path restrictions on Windows.
The following snipped needs to be run on `powershell` :
2024-05-02 13:44:48 -04:00
``` powershell
2022-09-26 09:20:43 -04:00
# Create a folder under the drive root
mkdir \ actions-runner ; cd \ actions-runner
# Download the latest runner package
Invoke-WebRequest -Uri https : / / github . com / actions / runner / releases / download / v < RUNNER_VERSION > / actions-runner -win -arm64 - < RUNNER_VERSION > . zip -OutFile actions-runner -win -arm64 - < RUNNER_VERSION > . zip
# Extract the installer
Add-Type -AssemblyName System . IO . Compression . FileSystem ;
[ System.IO.Compression.ZipFile ] :: ExtractToDirectory ( " $PWD \actions-runner-win-arm64-<RUNNER_VERSION>.zip " , " $PWD " )
```
2022-05-20 12:28:52 -04:00
## OSX x64
2019-10-10 00:52:42 -04:00
2024-05-02 13:44:48 -04:00
``` bash
2020-04-20 04:11:44 +02:00
# Create a folder
2019-11-19 16:27:36 -05:00
mkdir actions-runner && cd actions-runner
2020-04-20 04:11:44 +02:00
# Download the latest runner package
2020-01-21 12:23:30 -05:00
curl -O -L https://github.com/actions/runner/releases/download/v<RUNNER_VERSION>/actions-runner-osx-x64-<RUNNER_VERSION>.tar.gz
2020-04-20 04:11:44 +02:00
# Extract the installer
2019-11-19 16:27:36 -05:00
tar xzf ./actions-runner-osx-x64-<RUNNER_VERSION>.tar.gz
2019-10-10 00:52:42 -04:00
```
2022-08-23 16:42:40 +02:00
## OSX arm64 (Apple silicon)
2022-05-20 12:28:52 -04:00
2024-05-02 13:44:48 -04:00
``` bash
2022-05-20 12:28:52 -04:00
# Create a folder
mkdir actions-runner && cd actions-runner
# Download the latest runner package
curl -O -L https://github.com/actions/runner/releases/download/v<RUNNER_VERSION>/actions-runner-osx-arm64-<RUNNER_VERSION>.tar.gz
# Extract the installer
tar xzf ./actions-runner-osx-arm64-<RUNNER_VERSION>.tar.gz
```
2019-10-10 00:52:42 -04:00
## Linux x64
2024-05-02 13:44:48 -04:00
``` bash
2020-04-20 04:11:44 +02:00
# Create a folder
2019-11-19 16:27:36 -05:00
mkdir actions-runner && cd actions-runner
2020-04-20 04:11:44 +02:00
# Download the latest runner package
2020-01-21 12:23:30 -05:00
curl -O -L https://github.com/actions/runner/releases/download/v<RUNNER_VERSION>/actions-runner-linux-x64-<RUNNER_VERSION>.tar.gz
2020-04-20 04:11:44 +02:00
# Extract the installer
2019-11-19 16:27:36 -05:00
tar xzf ./actions-runner-linux-x64-<RUNNER_VERSION>.tar.gz
2019-10-10 00:52:42 -04:00
```
2019-11-13 11:26:06 -05:00
2021-04-23 05:26:31 -04:00
## Linux arm64
2019-11-13 11:26:06 -05:00
2024-05-02 13:44:48 -04:00
``` bash
2020-04-20 04:11:44 +02:00
# Create a folder
2019-11-19 16:27:36 -05:00
mkdir actions-runner && cd actions-runner
2020-04-20 04:11:44 +02:00
# Download the latest runner package
2020-01-21 12:23:30 -05:00
curl -O -L https://github.com/actions/runner/releases/download/v<RUNNER_VERSION>/actions-runner-linux-arm64-<RUNNER_VERSION>.tar.gz
2020-04-20 04:11:44 +02:00
# Extract the installer
2019-11-19 16:27:36 -05:00
tar xzf ./actions-runner-linux-arm64-<RUNNER_VERSION>.tar.gz
2019-11-13 11:26:06 -05:00
```
2021-04-23 05:26:31 -04:00
## Linux arm
2019-11-13 11:26:06 -05:00
2024-05-02 13:44:48 -04:00
``` bash
2020-04-20 04:11:44 +02:00
# Create a folder
2019-11-19 16:27:36 -05:00
mkdir actions-runner && cd actions-runner
2020-04-20 04:11:44 +02:00
# Download the latest runner package
2020-01-21 12:23:30 -05:00
curl -O -L https://github.com/actions/runner/releases/download/v<RUNNER_VERSION>/actions-runner-linux-arm-<RUNNER_VERSION>.tar.gz
2020-04-20 04:11:44 +02:00
# Extract the installer
2019-11-19 16:27:36 -05:00
tar xzf ./actions-runner-linux-arm-<RUNNER_VERSION>.tar.gz
```
## Using your self hosted runner
2024-05-02 13:44:48 -04:00
2019-11-19 16:27:36 -05:00
For additional details about configuring, running, or shutting down the runner please check out our [product docs. ](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/adding-self-hosted-runners )
2021-01-28 15:32:41 -05:00
## SHA-256 Checksums
The SHA-256 checksums for the packages included in this build are shown below:
- actions-runner-win-x64-<RUNNER_VERSION>.zip <!-- BEGIN SHA win-x64 --><WIN_X64_SHA><!-- END SHA win-x64 -->
2022-09-26 09:20:43 -04:00
- actions-runner-win-arm64-<RUNNER_VERSION>.zip <!-- BEGIN SHA win-arm64 --><WIN_ARM64_SHA><!-- END SHA win-arm64 -->
2021-01-28 15:32:41 -05:00
- actions-runner-osx-x64-<RUNNER_VERSION>.tar.gz <!-- BEGIN SHA osx-x64 --><OSX_X64_SHA><!-- END SHA osx-x64 -->
2022-05-20 12:28:52 -04:00
- actions-runner-osx-arm64-<RUNNER_VERSION>.tar.gz <!-- BEGIN SHA osx-arm64 --><OSX_ARM64_SHA><!-- END SHA osx-arm64 -->
2021-01-28 15:32:41 -05:00
- actions-runner-linux-x64-<RUNNER_VERSION>.tar.gz <!-- BEGIN SHA linux-x64 --><LINUX_X64_SHA><!-- END SHA linux-x64 -->
- actions-runner-linux-arm64-<RUNNER_VERSION>.tar.gz <!-- BEGIN SHA linux-arm64 --><LINUX_ARM64_SHA><!-- END SHA linux-arm64 -->
- actions-runner-linux-arm-<RUNNER_VERSION>.tar.gz <!-- BEGIN SHA linux-arm --><LINUX_ARM_SHA><!-- END SHA linux-arm -->