2023-09-07 10:48:53 -04:00
## What's Changed
2025-11-19 09:24:04 -05:00
* Custom Image: Preflight checks by @lawrencegripper in https://github.com/actions/runner/pull/4081
* Update dotnet sdk to latest version @8 .0.415 by @github -actions[bot] in https://github.com/actions/runner/pull/4080
* Link to an extant discussion category by @jsoref in https://github.com/actions/runner/pull/4084
* Improve logic around decide IsHostedServer. by @TingluoHuang in https://github.com/actions/runner/pull/4086
* chore: update Node versions by @github -actions[bot] in https://github.com/actions/runner/pull/4093
* Compare updated template evaluator by @ericsciple in https://github.com/actions/runner/pull/4092
* fix(dockerfile): set more lenient permissions on /home/runner by @caxu -rh in https://github.com/actions/runner/pull/4083
* Add support for libicu73-76 for newer Debian/Ubuntu versions by @lets -build-an-ocean in https://github.com/actions/runner/pull/4098
* Bump actions/download-artifact from 5 to 6 by @dependabot [bot] in https://github.com/actions/runner/pull/4089
* Bump actions/upload-artifact from 4 to 5 by @dependabot [bot] in https://github.com/actions/runner/pull/4088
* Bump Azure.Storage.Blobs from 12.25.1 to 12.26.0 by @dependabot [bot] in https://github.com/actions/runner/pull/4077
* Only start runner after network is online by @dupondje in https://github.com/actions/runner/pull/4094
* Retry http error related to DNS resolution failure. by @TingluoHuang in https://github.com/actions/runner/pull/4110
* Update Docker to v29.0.1 and Buildx to v0.30.0 by @github -actions[bot] in https://github.com/actions/runner/pull/4114
* chore: update Node versions by @github -actions[bot] in https://github.com/actions/runner/pull/4115
* Update dotnet sdk to latest version @8 .0.416 by @github -actions[bot] in https://github.com/actions/runner/pull/4116
* Compare updated workflow parser for ActionManifestManager by @ericsciple in https://github.com/actions/runner/pull/4111
* Bump npm pkg version for hashFiles. by @TingluoHuang in https://github.com/actions/runner/pull/4122
2024-11-13 12:20:10 -05:00
2025-07-07 15:19:21 -04:00
## New Contributors
2025-11-19 09:24:04 -05:00
* @lawrencegripper made their first contribution in https://github.com/actions/runner/pull/4081
* @caxu -rh made their first contribution in https://github.com/actions/runner/pull/4083
* @lets -build-an-ocean made their first contribution in https://github.com/actions/runner/pull/4098
* @dupondje made their first contribution in https://github.com/actions/runner/pull/4094
2025-07-07 15:19:21 -04:00
2025-11-19 09:24:04 -05:00
**Full Changelog ** : https://github.com/actions/runner/compare/v2.329.0...v2.330.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 -->