Provider Troubleshooting
This page covers issues related to CI provider integrations (e.g. GitHub Actions).
📡 Workflow Status Doesn't Update
Symptom: Action appears stuck in $Running$ state.
Cause: Webhook not received from GitHub.
Resolution:
- Confirm the GitHub App webhook is pointing to:
$https://your-domain.com/api/github/webhook$ - Make sure the GitHub App is subscribed to the following events:
- $workflow_run$
- $workflow_job$
- To check recent webhook deliveries:
- Go to $Settings > Developer settings > GitHub Apps$
- Click Edit next to your GitHub App
- In the sidebar, click Advanced
- Under Recent Deliveries, inspect event payloads and responses
❌ Cannot Trigger Workflow
Symptom: Clicking $Run$ shows an error or no response.
Cause: GitHub App not installed correctly or the private key is missing/invalid.
Resolution:
- Reinstall the GitHub App and verify the installation ID
- Use a correctly base64-encoded private key
(see: $GitHub Actions Setup$)