2021-09-29 15:49:40 -04:00
## Bugs
2022-09-02 17:43:22 +02:00
- Fixed an issue where job and service container envs were corrupted (#2091 )
2022-04-12 16:34:15 +02:00
## Misc
2021-11-01 11:16:21 -04:00
2019-10-10 00:52:42 -04:00
## Windows x64
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` :
``` powershell
# 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-05-20 12:28:52 -04:00
## OSX x64
2019-10-10 00:52:42 -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
` `` bash
# 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
` `` 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
` `` 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
` `` 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
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 -->
- 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 -->
2021-12-15 22:05:58 -05:00
- actions-runner-win-x64-<RUNNER_VERSION>-noexternals.zip <!-- BEGIN SHA win-x64_noexternals --><WIN_X64_SHA_NOEXTERNALS><!-- END SHA win-x64_noexternals -->
- actions-runner-osx-x64-<RUNNER_VERSION>-noexternals.tar.gz <!-- BEGIN SHA osx-x64_noexternals --><OSX_X64_SHA_NOEXTERNALS><!-- END SHA osx-x64_noexternals -->
2022-05-20 12:28:52 -04:00
- actions-runner-osx-arm64-<RUNNER_VERSION>-noexternals.tar.gz <!-- BEGIN SHA osx-arm64_noexternals --><OSX_ARM64_SHA_NOEXTERNALS><!-- END SHA osx-arm64_noexternals -->
2021-12-15 22:05:58 -05:00
- actions-runner-linux-x64-<RUNNER_VERSION>-noexternals.tar.gz <!-- BEGIN SHA linux-x64_noexternals --><LINUX_X64_SHA_NOEXTERNALS><!-- END SHA linux-x64_noexternals -->
- actions-runner-linux-arm64-<RUNNER_VERSION>-noexternals.tar.gz <!-- BEGIN SHA linux-arm64_noexternals --><LINUX_ARM64_SHA_NOEXTERNALS><!-- END SHA linux-arm64_noexternals -->
- actions-runner-linux-arm-<RUNNER_VERSION>-noexternals.tar.gz <!-- BEGIN SHA linux-arm_noexternals --><LINUX_ARM_SHA_NOEXTERNALS><!-- END SHA linux-arm_noexternals -->
- actions-runner-win-x64-<RUNNER_VERSION>-noruntime.zip <!-- BEGIN SHA win-x64_noruntime --><WIN_X64_SHA_NORUNTIME><!-- END SHA win-x64_noruntime -->
- actions-runner-osx-x64-<RUNNER_VERSION>-noruntime.tar.gz <!-- BEGIN SHA osx-x64_noruntime --><OSX_X64_SHA_NORUNTIME><!-- END SHA osx-x64_noruntime -->
2022-05-20 12:28:52 -04:00
- actions-runner-osx-arm64-<RUNNER_VERSION>-noruntime.tar.gz <!-- BEGIN SHA osx-arm64_noruntime --><OSX_ARM64_SHA_NORUNTIME><!-- END SHA osx-arm64_noruntime -->
2021-12-15 22:05:58 -05:00
- actions-runner-linux-x64-<RUNNER_VERSION>-noruntime.tar.gz <!-- BEGIN SHA linux-x64_noruntime --><LINUX_X64_SHA_NORUNTIME><!-- END SHA linux-x64_noruntime -->
- actions-runner-linux-arm64-<RUNNER_VERSION>-noruntime.tar.gz <!-- BEGIN SHA linux-arm64_noruntime --><LINUX_ARM64_SHA_NORUNTIME><!-- END SHA linux-arm64_noruntime -->
- actions-runner-linux-arm-<RUNNER_VERSION>-noruntime.tar.gz <!-- BEGIN SHA linux-arm_noruntime --><LINUX_ARM_SHA_NORUNTIME><!-- END SHA linux-arm_noruntime -->
- actions-runner-win-x64-<RUNNER_VERSION>-noruntime-noexternals.zip <!-- BEGIN SHA win-x64_noruntime_noexternals --><WIN_X64_SHA_NORUNTIME_NOEXTERNALS><!-- END SHA win-x64_noruntime_noexternals -->
- actions-runner-osx-x64-<RUNNER_VERSION>-noruntime-noexternals.tar.gz <!-- BEGIN SHA osx-x64_noruntime_noexternals --><OSX_X64_SHA_NORUNTIME_NOEXTERNALS><!-- END SHA osx-x64_noruntime_noexternals -->
2022-05-20 12:28:52 -04:00
- actions-runner-osx-arm64-<RUNNER_VERSION>-noruntime-noexternals.tar.gz <!-- BEGIN SHA osx-arm64_noruntime_noexternals --><OSX_ARM64_SHA_NORUNTIME_NOEXTERNALS><!-- END SHA osx-arm64_noruntime_noexternals -->
2021-12-15 22:05:58 -05:00
- actions-runner-linux-x64-<RUNNER_VERSION>-noruntime-noexternals.tar.gz <!-- BEGIN SHA linux-x64_noruntime_noexternals --><LINUX_X64_SHA_NORUNTIME_NOEXTERNALS><!-- END SHA linux-x64_noruntime_noexternals -->
- actions-runner-linux-arm64-<RUNNER_VERSION>-noruntime-noexternals.tar.gz <!-- BEGIN SHA linux-arm64_noruntime_noexternals --><LINUX_ARM64_SHA_NORUNTIME_NOEXTERNALS><!-- END SHA linux-arm64_noruntime_noexternals -->
- actions-runner-linux-arm-<RUNNER_VERSION>-noruntime-noexternals.tar.gz <!-- BEGIN SHA linux-arm_noruntime_noexternals --><LINUX_ARM_SHA_NORUNTIME_NOEXTERNALS><!-- END SHA linux-arm_noruntime_noexternals -->