GitHub App Installation

Installing a GitHub App is required to deploy your code to Connect Cloud.

Install GitHub App

Before publishing for the first time, you will be asked to install our GitHub App.

  1. Click Install. This will redirect you to GitHub.
  2. Select where you want to install the Posit Connect Cloud GitHub App.
  3. Select All repositories to grant Connect Cloud access to all of your code or Only select repositories to select specific repositories.
  4. Click Install and confirm access.

This redirects you back to Connect Cloud with the ability to deploy content from your authorized GitHub repositories.

Note: If you choose to allow access to only selected repositories, you’ll need to update your selections whenever you add new repositories that you want to deploy to Connect Cloud.

Manage GitHub App

Update Repository Access

  1. Visit https://github.com/settings/installations
  2. Click Configure for the Posit Connect Cloud installed app
  3. Scroll down to Repository access
  4. Make desired changes
  5. Click Save

Revoke Access

  1. Visit https://github.com/settings/installations
  2. Click Configure for the Posit Connect Cloud installed app
  3. Scroll down to Danger zone
  4. Click Suspend or Uninstall
  5. Confirm the change

Please note that if you revoke access to Connect Cloud you will not be able to deploy any new content until you install the GitHub App again.

Automatically Publish on Push

Installing the GitHub App allows your content to automatically republish whenever new commits are pushed to the connected branch. This ensures that your viewers always see the most up-to-date version without needing a manual re-deployment action on the platform. Learn more.

Limitations

Each Connect Cloud account is only allowed to use one GitHub App installation. Additionally, a GitHub App installation in any one GitHub account may only be linked to one Connect Cloud account.