2023-09-07 10:48:53 -04:00
## What's Changed
2022-09-26 11:22:05 -04:00
2024-05-02 13:44:48 -04:00
- Preserve dates when deserializing job message from Run Service by @ericsciple in https://github.com/actions/runner/pull/3269
2024-03-22 11:38:53 -04:00
2024-05-02 13:44:48 -04:00
**Full Changelog ** : https://github.com/actions/runner/compare/v2.316.0...v2.316.1
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
```
2022-09-26 09:20:43 -04:00
## [Pre-release] Windows arm64
2024-05-02 13:44:48 -04:00
2022-09-26 09:20:43 -04:00
**Warning: ** Windows arm64 runners are currently in preview status and use [unofficial versions of nodejs ](https://unofficial-builds.nodejs.org/ ). They are not intended for production workflows.
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 -->