Docs / Apps

Deploy on push

4 minute read

Every push to your app's branch can build and deploy a new version. Apps created from GitHub do this already; for GitLab or CI, add the app's webhook.

1. Find the webhook URL

Open the app and go to Settings → Deploy on push. Copy the private webhook URL. It looks like this:

https://console.simplicloud.ai/api/v1/webhooks/apps/2c41…/••••••••

2. Add it to GitHub or GitLab

• •GitHub: Repository → Settings → Webhooks → Add webhook. Paste the URL, set the content type to application/json and choose Just the push event.
• •GitLab: Settings → Webhooks. Paste the URL and tick Push events.

Only pushes to the branch in the app's build settings deploy. Pushes to other branches are ignored.

3. Deploy from CI instead

To deploy only after tests pass, leave the webhook out of the repository and call it from your pipeline:

name: deploy
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test
      - run: curl -fsS -X POST "$DEPLOY_HOOK"
        env:
          DEPLOY_HOOK: ${{ secrets.SIMPLICLOUD_DEPLOY_HOOK }}

Or use the CLI with an API key: simplicloud apps deploy storefront.

4. Follow and roll back

Each deploy appears on the Deployments tab with its commit and status.

simplicloud apps deploys storefront
simplicloud apps rollback storefront b81e9a0