Skip to content

armgit / muxin

Public Imported from GitHub
0

All your machines, one app. For you and your AI agents: agent sessions, desktops, files, logs and GitHub across your Macs, Linux and Windows machines, with an MCP server.

5.3 KB
Raw Blame
# Muxin: install GitHub Actions runners (macOS / Linux).
# Muxin prepends these variables:
#   OR_VERSION  runner release, e.g. 2.329.0
#   OR_SHA256   each package's SHA-256 from the release notes, space separated
#               <platform>=<hex> (e.g. linux-x64=194f...)
#   OR_URL      https://github.com/<org> or https://github.com/<owner>/<repo>
#   OR_TOKEN    registration token (short-lived)
#   OR_NAMES    runner names, space separated
#   OR_LABELS   extra labels, comma separated (may be empty)
#   OR_GROUP    runner group (may be empty)
#   OR_SERVICE  1 to install as a service, 0 to start with run.sh
#   OR_BASE     install root (empty: $HOME/actions-runner)

set -u
say() { printf '%s\n' "$*"; }
fail() { printf 'error: %s\n' "$*" >&2; exit 1; }

os=$(uname -s)
arch=$(uname -m)
case "$os" in
  Darwin) ros=osx ;;
  Linux) ros=linux ;;
  *) fail "Unsupported operating system: $os" ;;
esac
case "$arch" in
  x86_64 | amd64) rarch=x64 ;;
  arm64 | aarch64) rarch=arm64 ;;
  armv7l | armv6l | arm) rarch=arm ;;
  *) fail "Unsupported CPU architecture: $arch" ;;
esac

base="${OR_BASE:-$HOME/actions-runner}"
pkg="actions-runner-$ros-$rarch-$OR_VERSION.tar.gz"
url="https://github.com/actions/runner/releases/download/v$OR_VERSION/$pkg"
cache="$base/.cache"

# The package has to match the SHA-256 GitHub published for it, downloaded or cached.
sha=""
for entry in $OR_SHA256; do
  case "$entry" in
    "$ros-$rarch="*) sha=${entry#*=} ;;
  esac
done
[ -n "$sha" ] || fail "GitHub's release notes for actions-runner $OR_VERSION don't list a SHA-256 for $pkg, so it can't be checked. Not installing it."
if command -v sha256sum >/dev/null 2>&1; then
  sha256() { sha256sum "$1" | awk '{ print $1 }'; }
elif command -v shasum >/dev/null 2>&1; then
  sha256() { shasum -a 256 "$1" | awk '{ print $1 }'; }
else
  fail "Neither sha256sum nor shasum is installed, so the runner package can't be checked."
fi

SUDO=""
if [ "$ros" = linux ] && [ "$(id -u)" != 0 ]; then
  SUDO="sudo -n"
fi
if [ "$ros" = linux ] && [ "$(id -u)" = 0 ]; then
  # config.sh refuses to run as root unless told it's intended.
  export RUNNER_ALLOW_RUNASROOT=1
  say "Running as root; the runners will run as root too."
fi

# Fail before touching anything if the service can't be installed.
if [ "$OR_SERVICE" = 1 ] && [ -n "$SUDO" ]; then
  if ! sudo -n true 2>/dev/null; then
    fail "Installing a Linux service needs root, and sudo asks for a password over ssh. Allow passwordless sudo for $(id -un), or turn off \"Install as a service\" and later run: sudo ./svc.sh install $(id -un) && sudo ./svc.sh start"
  fi
fi

for name in $OR_NAMES; do
  if [ -f "$base/$name/.runner" ]; then
    fail "$base/$name already has a configured runner. Remove it first or pick another name."
  fi
done

mkdir -p "$cache" || fail "Couldn't create $cache"
if [ -s "$cache/$pkg" ] && [ "$(sha256 "$cache/$pkg")" = "$sha" ]; then
  say "Using cached $pkg"
else
  if [ -e "$cache/$pkg" ]; then
    say "The cached $pkg doesn't match its SHA-256; downloading it again."
    rm -f "$cache/$pkg" || fail "Couldn't delete $cache/$pkg"
  fi
  say "Downloading actions-runner $OR_VERSION for $ros-${rarch}…"
  if command -v curl >/dev/null 2>&1; then
    curl -fsSL --retry 3 -o "$cache/$pkg.part" "$url" || fail "Download failed: $url"
  elif command -v wget >/dev/null 2>&1; then
    wget -q -O "$cache/$pkg.part" "$url" || fail "Download failed: $url"
  else
    fail "Neither curl nor wget is installed."
  fi
  got=$(sha256 "$cache/$pkg.part")
  if [ "$got" != "$sha" ]; then
    rm -f "$cache/$pkg.part"
    fail "The downloaded $pkg doesn't match the SHA-256 GitHub published for it (expected $sha, got ${got:-nothing}), so it was deleted. Try again. If it keeps happening, something between this machine and GitHub is changing the download."
  fi
  mv "$cache/$pkg.part" "$cache/$pkg" || fail "Couldn't save $pkg"
fi
say "Checked $pkg against GitHub's SHA-256"

for name in $OR_NAMES; do
  dir="$base/$name"
  say "Setting up $name in $dir"
  mkdir -p "$dir" || fail "Couldn't create $dir"
  tar xzf "$cache/$pkg" -C "$dir" || fail "Couldn't unpack $pkg into $dir"
  cd "$dir" || fail "Couldn't enter $dir"

  set -- --unattended --url "$OR_URL" --name "$name" --work _work --replace
  [ -n "$OR_LABELS" ] && set -- "$@" --labels "$OR_LABELS"
  [ -n "$OR_GROUP" ] && set -- "$@" --runnergroup "$OR_GROUP"
  # The token goes in config.sh's environment, not its arguments: any account
  # on the machine can read those with ps.
  ACTIONS_RUNNER_INPUT_TOKEN=$OR_TOKEN ./config.sh "$@" || fail "config.sh failed for $name. On Linux, missing libraries can be installed with: sudo $dir/bin/installdependencies.sh"

  if [ "$OR_SERVICE" = 1 ]; then
    say "Installing $name as a service…"
    if [ "$ros" = linux ]; then
      $SUDO ./svc.sh install "$(id -un)" || fail "svc.sh install failed for $name"
      $SUDO ./svc.sh start || fail "svc.sh start failed for $name"
    else
      ./svc.sh install || fail "svc.sh install failed for $name"
      ./svc.sh start || fail "svc.sh start failed for $name. macOS runs runner services in the user's login session: make sure $(id -un) is logged in (automatic login helps on headless Macs)."
    fi
  else
    say "Starting $name in the background (not a service, so it won't come back after a reboot)…"
    nohup ./run.sh </dev/null >/dev/null 2>&1 &
  fi
  say "✓ $name is installed"
done