Connect GitHub and deploy from your repository

Connecting GitHub lets strackt browse your repositories, pull your code, and — if you want — deploy automatically every time you push. You connect once, and from then on every application your workspace adds can pick a repository you've granted access to.

Connect your GitHub account

Choose Connect GitHub. GitHub asks you to install the strackt app and pick which repositories it can access — all of them, or only the ones you choose. Approve the access, and GitHub sends you back to strackt with your account showing as connected.

You only do this once per workspace. After that, GitHub appears as an available source whenever any member adds or configures an application. Want to add or remove repositories later? Adjust the app's access from GitHub and the change takes effect right away.

What strackt sets up for you

When you link a repository to an application, there's nothing to configure by hand:

• strackt pulls your code over a secure connection using short-lived access it requests only for that deploy. Nothing long-lived is stored on your repository.
• strackt learns the moment you push through GitHub's app events — you don't add a webhook to your repository yourself.

You don't create or copy SSH keys, and you don't configure anything on GitHub yourself — granting the app access to the repository is all it needs.

Deploy automatically on push

With auto-deploy turned on, pushing to your application's configured branch deploys it automatically — no need to come back to strackt and trigger a deploy. Push to a different branch and nothing happens; only the branch your application tracks triggers a deploy.

Prefer to deploy on your own schedule? Turn auto-deploy off, and strackt only deploys when you ask it to.

If setup didn't finish

If strackt couldn't reach the repository — for example, the app hasn't been granted access to it — your application shows a Setup incomplete badge on its deployment settings, with a short message describing what went wrong. Read the message, grant the app access to the repository on GitHub, and retry. Once strackt can reach the repository again, the message clears on its own.

Disconnect

Disconnecting removes strackt's link to your repositories cleanly — nothing is left running on strackt's side. To also revoke strackt's access on GitHub, uninstall or suspend the strackt app from your GitHub settings. If you uninstall or suspend the app on GitHub, strackt disconnects the affected repositories automatically; reconnect the app whenever you're ready to deploy from them again.

What to do next

• Ready to add an application from a connected repository? See Add and deploy an application.
• Want to understand what happens on each deploy? See How deploys work.