Skip to main content

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:
    1. Go to $Settings > Developer settings > GitHub Apps$
    2. Click Edit next to your GitHub App
    3. In the sidebar, click Advanced
    4. 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$)