Deploying / Connecting GitHub
Connecting GitHub
Riven deploys straight from your GitHub repos. To do that, you connect your GitHub account once. After that, Riven can read the repos you pick and redeploy them automatically whenever you push.
Connect your account
The first time you click New Service, Riven asks you to connect GitHub. This opens GitHub, where you install the Riven app on your account.
- Click New Service from your dashboard.
- Choose Connect GitHub.
- GitHub opens — review the access and confirm the install.
- You land back on Riven, ready to pick a repo.
You only do this once. After connecting, your repos show up directly in Rivenwhenever you create a new service.
Choosing repo access
When you install the Riven app, GitHub gives you two choices for how much access to grant:
- All repositories — Riven can see every repo on your account, including ones you add later. Simplest if you plan to deploy several projects.
- Only select repositories — you hand-pick which repos Riven can see. Everything else stays private to Riven. Best if you only want to deploy one or two projects.
Pick whichever you're comfortable with — you can change it anytime. If you choose "only select" and want to deploy a new repo later, you'lljust add it to the list.
What Riven can see
Riven asks for the minimum access it needs to build and deploy your code:
- Read your code — to clone the repo and build it.
- Read commits and branches — to know what to deploy and from which branch.
- Receive push events — so it can redeploy automatically when you push.
Riven does not write to your code, and it only touches the repos you grant access to. Your other repos stay invisible to it.
Add or remove repos later
Changed your mind about which repos Riven can deploy? You manage this from GitHub, not from Riven:
- Go to your GitHub Settings → Applications → Installed GitHub Apps.
- Find Riven and click Configure.
- Add or remove repositories, then save.
If a repo you want to deploy isn't showing up in Riven, this is almost always why — it hasn't been granted access yet. Add it here and it'll appear.
Disconnect GitHub
To remove Riven's access completely, uninstall the app from GitHub:
- Go to GitHub Settings → Applications → Installed GitHub Apps.
- Click Configure on Riven, scroll down, and choose Uninstall.
Uninstalling stops all auto-deploys. Your already-deployed apps keep running, butRiven won't be able to build new versions until you reconnect.
Troubleshooting
My repo isn't showing up.
It probably hasn't been granted access. Go to GitHub → Installed Apps → Riven → Configure, and add the repo. See Add or remove repos above.
I connected the wrong GitHub account.
Uninstall Riven from that account (see Disconnect), then connect again with the correct one.
Auto-deploy isn't triggering on push.
Make sure auto-deploy is on for that service (Settings → Auto Deploy), and that you're pushing to the branch it's set to deploy from. More in Auto-Deploy.