Skip to content

How to setup GitHub hosted runner with a simple cloud-init script

Edit: RunsOn is now available for installation!

While waiting for the RunsOn ephemeral self-hosted runners service, here is a short bash script, that can also be used as cloud-init script for launching GitHub hosted runners non-interactively:

#!/bin/bash -ex
set -o pipefail
# Install docker, then additional packages and stuff:
apt update -qq
apt install -y ruby awscli
curl | tar -xJf - --strip=1 -C /usr/local/
curl | sh
cat > /etc/cron.daily/docker-prune <<EOF
docker image prune -a --filter="until=96h" --force
docker volume prune --force
chmod a+x /etc/cron.daily/docker-prune
# Create dedicated user
useradd -m -d /home/runner -s /bin/bash runner
usermod -G docker runner
# Download and install runner script
cd /home/runner
mkdir -p actions-runner
cd actions-runner
curl -o actions-runner-linux-x64-$RUNNER_VERSION.tar.gz -L$RUNNER_VERSION/actions-runner-linux-x64-$RUNNER_VERSION.tar.gz
tar xzf ./actions-runner-linux-x64-$RUNNER_VERSION.tar.gz
# Configure runner
su - runner -c "
/home/runner/actions-runner/ --url$RUNNER_ORG --token $RUNNER_TOKEN --labels $RUNNER_LABELS --unattended
# Setup systemd scripts
cd /home/runner/actions-runner/
./ install runner
./ start
./ status

You should be good to go!

Note that those runners won’t be ephemeral, so usual caveats apply regarding security of those runners.