# Troubleshooting

## 401 Bad credentials during runner registration
- Ensure `gh auth status` shows the correct account
- Confirm scopes include `repo` and `workflow`
- Use `gh api -X POST` for token endpoints

## 404 Not Found for runner remove token
- Confirm you have access to the repo
- Verify the repo name and owner are correct

## Runner shows offline
- Check service status with `Get-Service`
- Restart the service
- Confirm the machine has outbound access to GitHub

## Offline notification fires but runner is healthy
- Confirm the runner name matches `MyLocalPC`
- Check `Runner Health Monitor` workflow logs for API errors

## Service fails to start
- Re-run registration steps
- Check Windows Event Viewer for service errors