GitHub Runner Timeout Troubleshooting
ocsGitHub
GitHub Runner Timeout
TroubleshootingIf you need to run a job for longer than six hours, there are a couple of options.
Self-Hosted Runners: You can use self-hosted runners, which allow you to bypass the six hour limit. Self-hosted runners will give you more control over the environment and can run jobs for longer periods
Timeout Configuration: You can specify a larger timeout value in your workflow configuration using the timeout-minutes parameter. However,Use this mightarticle not work forwhen GitHub hostedActions runners due to the enforced time limit
How to create self hosted runner in GitHub
Set Up Your Self-Hosted Runner
Access your repository on GitHub.
Navigate to Settings > Actions > Runners.
Click Add runner and follow the instructions to download and configure the runner application on your machine1.
Register the Runner
Run the provided registration command on your machine to connect it to your GitHub repository.
This will involve running a script that registers your machine asor a self-hosted runner1.
Configureout Yourwhile Workflow:
starting, Invalidating yourAIQ workflowwork. YAML file, specifyCorrected the runs-title prefix and focused the content onkeytimeout to use your self-hosted runner. diagnosis.
Here
Common ischecks
- Confirm
example yaml file withruns-onself-hosted andwhether the timeoutsettings.occursinjobs:
GitHubbuild:
Actions,runs-on:theself-hosted
runnertimeout-minutes:host,720AIQ#startup,Exampletest execution, or artifact upload. - Review workflow timeout settings, job-level timeouts, and step-level timeouts.
- Check runner host CPU, memory, disk space, network access, and service availability.
- Validate AIQ Controller/Test Node reachability from the runner.
- Reduce the workflow to a small smoke execution before running the full suite.
Resolution workflow
- Capture the workflow run ID, runner name, timestamps, and failing step.
- Compare GitHub logs with AIQ logs for
12thehours
samesteps:
time-window. - Increase
name:timeoutCheckoutvaluescode
onlyuses:afteractions/checkout@v2
confirming#theAddjobyourisstepsmakinghere
Last updated: MarchOctober 31,9, 20252026
If you have any feedback on this topic, please contact us at documentation@appvance.ai