Skip to content

GitHub Webhook Setup

Connect your GitHub repository to Nebion for automatic deployments.

Before You Start

  • Created a project in Nebion (how?)
  • Admin access to your GitHub repository
  • Webhook URL, secret, and deploy key from your Nebion project page (under Setup)
  1. Add Deploy Key

    In Nebion, copy the Deploy Key from your project page. In GitHub, go to Settings > Deploy keys > Add deploy key. Set title to Nebion Deploy Key, paste the public key, leave Allow write access unchecked, and click Add key.

  2. Create Webhook

    In GitHub, go to Settings > Webhooks > Add webhook. Fill in:

    FieldValue
    Payload URLPaste the Webhook URL from Nebion
    Content typeapplication/json
    SecretPaste the Webhook Secret from Nebion
    SSL verificationEnable SSL verification

    Under Which events would you like to trigger this webhook?, select Let me select individual events, then check only Pull requests. Make sure Active is checked and click Add webhook.

  3. Test It

    Create a test branch and pull request:

    bash
    git checkout -b test-nebion
    echo "test" >> README.md
    git add . && git commit -m "Test Nebion webhook"
    git push origin test-nebion

    Create a pull request on GitHub for this branch. In Nebion, check your project page — a new pr-{number} environment should appear. Once the deployment status shows SUCCESS, click the environment URL to verify.

WARNING

Keep the webhook secret secure. Do not commit it to your repository.

If the environment doesn't appear, check the webhook delivery history in GitHub under Settings > Webhooks > click your webhook > Recent Deliveries.