run.sh or run.cmd did not properly restart after update (#1812). This fix applies to all future updates after installing this versionWe 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:
# 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/v2.291.1/actions-runner-win-x64-2.291.1.zip -OutFile actions-runner-win-x64-2.291.1.zip
# Extract the installer
Add-Type -AssemblyName System.IO.Compression.FileSystem ;
[System.IO.Compression.ZipFile]::ExtractToDirectory("$PWD\actions-runner-win-x64-2.291.1.zip", "$PWD")
# Create a folder
mkdir actions-runner && cd actions-runner
# Download the latest runner package
curl -O -L https://github.com/actions/runner/releases/download/v2.291.1/actions-runner-osx-x64-2.291.1.tar.gz
# Extract the installer
tar xzf ./actions-runner-osx-x64-2.291.1.tar.gz
# Create a folder
mkdir actions-runner && cd actions-runner
# Download the latest runner package
curl -O -L https://github.com/actions/runner/releases/download/v2.291.1/actions-runner-linux-x64-2.291.1.tar.gz
# Extract the installer
tar xzf ./actions-runner-linux-x64-2.291.1.tar.gz
# Create a folder
mkdir actions-runner && cd actions-runner
# Download the latest runner package
curl -O -L https://github.com/actions/runner/releases/download/v2.291.1/actions-runner-linux-arm64-2.291.1.tar.gz
# Extract the installer
tar xzf ./actions-runner-linux-arm64-2.291.1.tar.gz
# Create a folder
mkdir actions-runner && cd actions-runner
# Download the latest runner package
curl -O -L https://github.com/actions/runner/releases/download/v2.291.1/actions-runner-linux-arm-2.291.1.tar.gz
# Extract the installer
tar xzf ./actions-runner-linux-arm-2.291.1.tar.gz
For additional details about configuring, running, or shutting down the runner please check out our product docs.
The SHA-256 checksums for the packages included in this build are shown below:
actions-runner-win-x64-2.291.1.zip <!-- BEGIN SHA win-x64 -->2a504f852b0ab0362d08a36a84984753c2ac159ef17e5d1cd93f661ecd367cbd<!-- END SHA win-x64 -->
actions-runner-osx-x64-2.291.1.tar.gz <!-- BEGIN SHA osx-x64 -->1ed51d6f35af946e97bb1e10f1272197ded20dd55186ae463563cd2f58f476dc<!-- END SHA osx-x64 -->
actions-runner-linux-x64-2.291.1.tar.gz <!-- BEGIN SHA linux-x64 -->1bde3f2baf514adda5f8cf2ce531edd2f6be52ed84b9b6733bf43006d36dcd4c<!-- END SHA linux-x64 -->
actions-runner-linux-arm64-2.291.1.tar.gz <!-- BEGIN SHA linux-arm64 -->c4823bd8322f80cb24a311ef49273f0677ff938530248242de7df33800a22900<!-- END SHA linux-arm64 -->
actions-runner-linux-arm-2.291.1.tar.gz <!-- BEGIN SHA linux-arm -->a78e86ba6428a28733730bdff3a807480f9eeb843f4c64bd1bbc45de13e61348<!-- END SHA linux-arm -->
actions-runner-win-x64-2.291.1-noexternals.zip <!-- BEGIN SHA win-x64_noexternals -->287920fa3a58417230078906151f492eac2819c4565accc04143cbc06c54f203<!-- END SHA win-x64_noexternals -->
actions-runner-osx-x64-2.291.1-noexternals.tar.gz <!-- BEGIN SHA osx-x64_noexternals -->3be33b523675ec5c1e00a919cab5d2ab94e3567149017ba99191befce2c51f58<!-- END SHA osx-x64_noexternals -->
actions-runner-linux-x64-2.291.1-noexternals.tar.gz <!-- BEGIN SHA linux-x64_noexternals -->50cc646f2a5948fe93743ff876aee28c0e527a3410aa53b7955cebf5b9c2ca35<!-- END SHA linux-x64_noexternals -->
actions-runner-linux-arm64-2.291.1-noexternals.tar.gz <!-- BEGIN SHA linux-arm64_noexternals -->f293f03bb1df90216c49acec7f58f839c1bde1e1c6e73963533fadaafcf0eaf4<!-- END SHA linux-arm64_noexternals -->
actions-runner-linux-arm-2.291.1-noexternals.tar.gz <!-- BEGIN SHA linux-arm_noexternals -->51506b64da93f6757ad8a52bfa21dcf65d8c14a934cf6cb5a169fd2c97995475<!-- END SHA linux-arm_noexternals -->
actions-runner-win-x64-2.291.1-noruntime.zip <!-- BEGIN SHA win-x64_noruntime -->7339d00c07fa25da978e81ee722098bd23875443c2ac60c06c0170b024508256<!-- END SHA win-x64_noruntime -->
actions-runner-osx-x64-2.291.1-noruntime.tar.gz <!-- BEGIN SHA osx-x64_noruntime -->b9f0d09c97eb5a5e2e109e7f36798524090d2e2a1307164bf28ab26c9e31e0e2<!-- END SHA osx-x64_noruntime -->
actions-runner-linux-x64-2.291.1-noruntime.tar.gz <!-- BEGIN SHA linux-x64_noruntime -->505772924a8a30e192329b5059b8f3efa3ddb1fe3d253c7422743c5d94ee2f34<!-- END SHA linux-x64_noruntime -->
actions-runner-linux-arm64-2.291.1-noruntime.tar.gz <!-- BEGIN SHA linux-arm64_noruntime -->8423ad89e9b1e4ea7b1de785616fbcffffb7fe3ceedd5b29fcacae06302ee0fe<!-- END SHA linux-arm64_noruntime -->
actions-runner-linux-arm-2.291.1-noruntime.tar.gz <!-- BEGIN SHA linux-arm_noruntime -->3bbcf13b84c3c6ad26a48fabf5f706682583a0f8bc96df386cf9d8cdfd521153<!-- END SHA linux-arm_noruntime -->
actions-runner-win-x64-2.291.1-noruntime-noexternals.zip <!-- BEGIN SHA win-x64_noruntime_noexternals -->8b6f2bfeffc84fc7ac8f3ec1c5521a73c1349753e5aa02db7c9b793f3ea9ae4e<!-- END SHA win-x64_noruntime_noexternals -->
actions-runner-osx-x64-2.291.1-noruntime-noexternals.tar.gz <!-- BEGIN SHA osx-x64_noruntime_noexternals -->c6983b410617c5866da8bf3e8d46a2bfcbae9ee32aaaea8805ff7b4346ba61cb<!-- END SHA osx-x64_noruntime_noexternals -->
actions-runner-linux-x64-2.291.1-noruntime-noexternals.tar.gz <!-- BEGIN SHA linux-x64_noruntime_noexternals -->ce3f00bb32df5aa4db757399b4debf1a4f2d924f6a07f236072ded4a4c2f16a8<!-- END SHA linux-x64_noruntime_noexternals -->
actions-runner-linux-arm64-2.291.1-noruntime-noexternals.tar.gz <!-- BEGIN SHA linux-arm64_noruntime_noexternals -->05cb977780d958d45be601708e38eddd2b138f69ea45b432763ec26a9baa8d50<!-- END SHA linux-arm64_noruntime_noexternals -->
actions-runner-linux-arm-2.291.1-noruntime-noexternals.tar.gz <!-- BEGIN SHA linux-arm_noruntime_noexternals -->958b260419389400074ae185ba7130d7e9ae1a1769f43dfbd1207cf3f48700a9<!-- END SHA linux-arm_noruntime_noexternals -->
Fetched April 8, 2026