From 23e6f9326d1d25f55c701d30fe73d9fa0ab3dc84 Mon Sep 17 00:00:00 2001 From: radiantjade Date: Fri, 15 May 2026 16:31:12 +0900 Subject: [PATCH] Explain GitHub deploy approval prompts Autodeploy troubleshooting already documented the repository permission requirements, but the approval prompt path did not explain that Railway also checks the Railway project member and connected GitHub identity. Add the missing explanation near the autodeploy requirements so affected users can fix membership or reconnect the repository before contacting support. Constraint: Central Station bounty asks what Railway checks before auto-deploying repo-owner commits Rejected: Add a separate troubleshooting page | one short section in the existing autodeploy page is easier to find Confidence: medium Scope-risk: narrow Tested: git diff --check; pnpm exec content-collections build --- content/docs/deployments/github-autodeploys.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/content/docs/deployments/github-autodeploys.md b/content/docs/deployments/github-autodeploys.md index 9b42c2799..ced079989 100644 --- a/content/docs/deployments/github-autodeploys.md +++ b/content/docs/deployments/github-autodeploys.md @@ -35,6 +35,18 @@ Public repositories where no project member has contributor access cannot use au If you cannot enable autodeploy, see [Troubleshooting](#troubleshooting). +### External contributor approval prompt + +Railway may ask you to approve a commit with the prompt **Deploy this commit from an external contributor?** when the commit author is not recognized as a project member who can deploy from the linked GitHub repository. + +Repository ownership and GitHub App access are not the only checks. To skip the approval prompt for future commits, make sure that: + +1. The Railway project includes a member with the [Deployer role or higher](/projects/workspaces#inviting-members). +2. That member has connected the GitHub account that authors the commits. +3. That GitHub account has contributor access to the linked repository. + +After changing membership, GitHub permissions, or the linked GitHub account, disconnect and reconnect the repository in the service settings if Railway keeps prompting for approval. + ## Wait for CI