Files
Giulio Vaccari e827e498a3 docs: lowercase repo URL and token in Pi setup guide
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-29 00:22:38 +02:00

1.4 KiB

Raspberry Pi Runner Setup

Use your Raspberry Pi as a persistent, self-hosted runner for Opencode Triage. This enables the use of gh copilot and other tools without re-authenticating on every run.

Prerequisites

  • A Raspberry Pi (3, 4, or 5) running Raspberry Pi OS (64-bit recommended) or Ubuntu.
  • Internet connection.
  • SSH access.

Step 1: Get your Token

  1. Go to your GitHub Repository.
  2. Navigate to Settings > Actions > Runners.
  3. Click New self-hosted runner.
  4. Select Linux and ARM64.
  5. Copy the Token shown in the "Configure" section (you'll need it in Step 2).

Step 2: Run the Setup Script

Copy the scripts/ folder to your Pi, or copy-paste the script content directly.

# On your Pi
mkdir -p ~/opencode-setup
cd ~/opencode-setup
# (Copy scripts/setup-pi-runner.sh here)
chmod +x setup-pi-runner.sh
./setup-pi-runner.sh

Follow the prompts to enter your repository URL and token.

Step 3: Authenticate Tools

To enable gh copilot and other AI tools, run the auth helper:

# (Copy scripts/auth-pi-tools.sh here)
chmod +x auth-pi-tools.sh
./auth-pi-tools.sh

Follow the interactive login flows.

Step 4: Update Workflow

Once your runner is "Idle" (green) in GitHub Settings, update your .github/workflows/issue-triage.yml:

runs-on: self-hosted
# or specifically:
# runs-on: [self-hosted, pi]