Skip to content

Commit 60a9476

Browse files
committed
Document steps for restoring removed GitHub self-hosted runner
1 parent f4a11a8 commit 60a9476

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

doc/maintainers/self-hosted_runners.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,23 @@ is for filesystem `/dev/sda1`.
6161
If the available space is low, that may be due to unncessary GHC versions
6262
installed in Stack's `programs` directory.
6363

64+
## Re-configuring a removed `stack-github-action3` runner
65+
66+
A self-hosted runner is automatically removed from GitHub if it has not
67+
connected to GitHub Actions for more than 14 days.
68+
69+
Re-adding a self-hosted runner to GitHub requires it to be configured, and
70+
GitHub will suggest a configuration command like:
71+
72+
~~~text
73+
./config.sh --url https://github.com/commercialhaskell/stack --token <token_value>
74+
~~~
75+
76+
However, to re-use and configure the runner machine, you have first to delete
77+
the `.runner` file inside the `actions-runner` directory. This allows the runner
78+
to be registered without having to re-download the self-hosted runner
79+
application.
80+
6481
## The `ghc-arm-5` runner
6582

6683
From 9 February 2024, the Haskell Foundation sought to provide an alternative

0 commit comments

Comments
 (0)