Back
Selfhosted Github App installation
I've followed this guide: https://appwrite.io/docs/advanced/self-hosting/configuration/version-control to connect GitHub to my self-hosted Appwrite instance (1.8.0, running on Coolify).
The GitHub App installs successfully, but after the redirect back to Appwrite there's no active connection. One thing I noticed: the Setup URL in the GitHub App settings needs to point to the Appwrite homepage — leaving it empty prevented the redirect entirely.
The logs show the following:
TypeScript
2026-Mar-12 08:19:56
Worker 22 started successfully
2026-Mar-12 08:19:56
Worker 23 started successfully
2026-Mar-12 08:19:56
Worker 24 started successfully
2026-Mar-12 08:19:56
[Setup] - logs database init started...
2026-Mar-12 08:19:56
└── Creating database: logs...
2026-Mar-12 08:19:56
└── Skip: metadata table already exists
2026-Mar-12 08:19:56
[Setup] - appwrite database init started...
2026-Mar-12 08:19:56
└── Creating database: appwrite...
2026-Mar-12 08:19:56
└── Skip: metadata table already exists
2026-Mar-12 08:19:56
[Setup] - Server database init completed...
2026-Mar-12 08:19:56
Server started successfully (max payload is 12,582,912 bytes)
2026-Mar-12 08:19:56
Master pid 1, manager pid 7
2026-Mar-12 08:20:14
localhost is not a publicly accessible domain. Skipping SSL certificate generation.
2026-Mar-12 08:25:15
appwrite.example.app is not a main domain. Skipping SSL certificate generation.
TL;DR
Developers are facing issues connecting GitHub to their self-hosted Appwrite instance. The solution is to ensure the Setup URL in the GitHub App settings points to the Appwrite homepage. The logs provided indicate that the Appwrite server is starting successfully.I think i figured it out, the setup url should be: <APPWRITE_HOME>/v1/vcs/github/authorize
Creating the installation with the following endpoint: https://github.com/appwrite/appwrite/blob/a5fa09b4ceb5945d98244612a3d8d1a780533e93/app/controllers/api/vcs.php#L524
