github-runner-setup

Configure systemd services for self-hosted GitHub Actions runners.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/stars-end/agent-skills --skill github-runner-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-runner-setup
Source: https://github.com/stars-end/agent-skills/tree/main/github-runner-setup
Command: npx skills add https://github.com/stars-end/agent-skills --skill github-runner-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHub Actions self-hosted runner setup and maintenance. Use when setting up dedicated runner users, migrating runners from personal accounts, troubleshooting runner issues, or implementing runner isolation. Covers systemd services, environment isolation, and skills plane integration.

Core Features & Use Cases

  • Environment Isolation: Runners run as dedicated runner user, not dev user
  • Systemd Management: Services auto-start on reboot, managed via systemd
  • Skills Plane Integration: Runner user has permanent ~/.agent/skills mount
  • Security: Minimal permissions for runner user (no sudo by default)

Quick Start

Use the github-runner-setup skill to configure and manage a self-hosted runner. Steps include creating a dedicated runner user, cloning agent-skills into the runner, and setting up the permanent skills mount; follow the full setup guide in docs/SELF_HOSTED_RUNNER_SETUP.md.

Frequently Asked Questions about github-runner-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a self-hosted GitHub Actions runner with proper isolation?

Self-hosted runner setup requires creating a dedicated runner user separate from your dev account, configuring systemd services for auto-restart capability, and mounting the skills plane at ~/.agent/skills. This isolates runner execution, ensures reliability across reboots, and maintains minimal permissions without sudo access by default.

What's the best way to migrate a GitHub Actions runner from a personal account to a dedicated user?

Migration involves creating a new dedicated runner user, transferring runner registration to that user context, and reconfiguring systemd services to manage the runner lifecycle. This removes runner privileges from personal accounts and establishes proper environment isolation for production workloads.

Why should I use systemd to manage GitHub Actions runners?

Systemd services auto-start runners on reboot, handle graceful restarts, and provide centralized lifecycle management. This eliminates manual intervention after system maintenance and ensures your runners remain available without requiring persistent shell sessions.

Can I troubleshoot GitHub Actions runner connectivity and execution issues?

Runner troubleshooting covers diagnosis of connectivity failures, execution errors, and environment misconfigurations. The skill guides isolation verification, systemd status inspection, and skills mount validation to resolve common operational issues.

Do I need sudo permissions to run a self-hosted GitHub Actions runner?

No. Self-hosted runners operate with minimal permissions by default; the dedicated runner user runs without sudo access. Elevated permissions are not required for standard runner operation and job execution within the isolated environment.

How does skills plane integration work with self-hosted runners?

The runner user receives a permanent ~/.agent/skills mount that persists across restarts. This integration allows runners to access shared skills resources while maintaining isolation boundaries and consistent environment state.