Skip to content

Commit 82e12b8

Browse files
committed
docs(country-instance-runbook): document GitHub App source for auto-deploy
Replaces the manual GitHub webhook steps (needed repo-admin access every setup) with switching the Coolify app's Git Source to the existing GitHub App connection — confirmed working for the GH/MY auto-deploy migration off the GitHub Actions Coolify-API trigger.
1 parent 2495d37 commit 82e12b8

1 file changed

Lines changed: 16 additions & 13 deletions

File tree

docs/country-instance-runbook.md

Lines changed: 16 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -79,19 +79,22 @@ In the Coolify "Persistent Storage" or "Volumes" tab, ensure these volumes are a
7979
| `mysql_data` | `/var/lib/mysql` | DB data — **never delete** |
8080
| `media` | `/var/www/html/media` | ALL instance media (course covers, uploads, email logo) |
8181

82-
### 3.4 Configure the webhook for auto-deploy
83-
84-
1. In Coolify, open the application → **"Webhooks"** tab.
85-
2. Copy the **Deploy Webhook URL**.
86-
3. In GitHub → repo Settings → Webhooks → **Add webhook**:
87-
- Payload URL: paste the Coolify deploy webhook URL
88-
- Content type: `application/json`
89-
- Secret: use the Coolify-provided secret (or leave blank if Coolify doesn't generate one)
90-
- Events: **Just the push event**
91-
- Branch filter: `main`
92-
4. Click **Add webhook** and verify it shows a green check on first ping.
93-
94-
Now every push to `main` redeploys **both** SG and this country instance automatically.
82+
### 3.4 Configure auto-deploy via the Coolify GitHub App source
83+
84+
Don't use a manually-pasted GitHub webhook — it requires repo-admin access on
85+
GitHub every time, and Coolify already has a self-managing alternative.
86+
87+
1. In Coolify, open the application → **Configuration → Git Source**.
88+
2. Under **Change Git Source**, select the existing GitHub App source (e.g.
89+
`ai-mms-gh`, listed under "Personal Account") instead of "Public GitHub".
90+
3. Click **Save**.
91+
4. Open the **Webhooks** tab to confirm — it should say *"You are using an
92+
official Git App. You do not need manual webhooks."* If you still see a
93+
manual "Deploy Webhook URL" prompt instead, the source switch didn't take;
94+
re-check step 2.
95+
96+
Now every push to `main` redeploys **both** SG and this country instance
97+
automatically — no GitHub Settings → Webhooks entry needed at all.
9598

9699
### 3.5 First deploy
97100

0 commit comments

Comments
 (0)