Skip to main content

Connect GitHub and Choose Repositories

Skysize connects to GitHub through the Skysize GitHub App. You decide which repositories it can reach: it never sees the rest of your account or organization.

Connect and install the app​

  1. Click Connect GitHub, from Account > Integration or inside the project wizard, and approve the request on GitHub.
  2. In the repository step, click Install Skysize on GitHub (or Install on another account or org). Pick your personal account or an organization.
  3. Choose All repositories or Only select repositories, then confirm. GitHub sends you back to Skysize and the repository list shows what you selected.
note

Installing the app on an organization may need an owner of that organization. If you are not one, GitHub sends them a request to approve.

A repository you create from the Skysize wizard is added to the installation automatically.

Add or remove repositories later​

Next to each account in the repository picker, click Manage repositories. GitHub opens the installation settings, where you add or remove repositories. Back in Skysize, click Refresh if the list has not updated yet.

A repository you create on GitHub itself is not added to a "selected repositories" installation: add it there before attaching it to a project.

If you remove a repository a project uses​

Pushes keep deploying: the deploy key and the push webhook stay on the repository. Anything that needs to change the repository fails until you add it back, with the message "owner/repo is not in the Skysize GitHub App installation": attaching it again, re-registering the webhook, installing deploy keys for private submodules. Add the repository back with Manage repositories, then retry.

Reconnect an older connection​

Connections made before the GitHub App reached every repository of your account. They keep working, and Account > Integration shows a banner with a Reconnect GitHub button. Reconnect to switch the connection to the app, then install it on the accounts your projects use: until you do, the repository list is empty.

Build and test checks on pull requests​

When the app is installed on a repository, every build adds two checks on the commit it deploys, also shown on the pull request:

  • Skysize / build: in progress while the branch deploys, then passed or failed. A failure shows the same short reason as the dashboard.
  • Skysize / tests: for development branches that run tests, passed or failed.

Details opens the build in Skysize. Checks are public to everyone who can read the repository, so they only carry the short reason, never logs. To turn them off for a project, open its Settings and switch off Build and test status on GitHub pull requests.