Skip to main content
Springwinter integrates with GitHub through an official GitHub App that you install on your personal account or organization. Once installed, Springwinter can listen for push events on the repositories you select, trigger builds automatically, and create isolated preview environments for feature branches — all without you ever sharing a personal access token or setting up a webhook manually.

Install the GitHub App

1

Open GitHub settings in the dashboard

Log in to the Springwinter dashboard and navigate to Settings → Source control. If you have not yet connected a GitHub account, you will see the Connect GitHub button.
2

Start the GitHub App installation

Click Connect GitHub. You are redirected to the GitHub App installation page on GitHub.com. If you are not already logged into GitHub, you will be prompted to do so.
3

Choose the GitHub account or organization

On the installation page, select the GitHub account — your personal account or any organization you administer — where you want to install the Springwinter App. If you manage multiple organizations, you can install the app separately on each one; each installation is independent.
4

Select repository access

Choose how much access to grant:
  • All repositories — Springwinter can see and build every current and future repository in the account or organization.
  • Only select repositories — pick specific repositories from the list. You can add more later by revisiting the GitHub App settings.
Select the option that matches your team’s security posture and click Install.
5

Confirm and return to Springwinter

GitHub asks you to confirm the installation. After you click Install & Authorize, GitHub redirects you back to the Springwinter dashboard automatically. Your installation appears immediately under Settings → Source control with the account name and the number of repositories accessible.

What Springwinter does with GitHub access

Review the permissions shown by GitHub before approving the installation. Springwinter uses installation access for:
  • Read repository contents — to clone your repository at the commit SHA being deployed.
  • Read repository metadata — to populate the repository and branch selectors in the dashboard.
  • Receive push webhook events — to trigger builds automatically when you push to a configured branch.
When a build starts, Springwinter mints a short-lived GitHub installation token scoped to the target repository. The control plane passes the token to CodeBuild for the build; it does not persist it in application records. Springwinter does not store GitHub tokens between builds.
A GitHub installation token is minted on demand and passed from the control plane to CodeBuild. It is not stored in the application database. The control plane and build process handle the token; do not describe it as visible only inside the clone process.

Auto-deploy behavior

Every resource (web server, worker, or static website) is linked to a specific GitHub repository and branch at creation time. When you push a commit to that branch:
  1. GitHub delivers a push webhook to Springwinter.
  2. Springwinter queues a new build for the resource.
  3. The build clones your repository at the new commit, builds the artifact (Docker image or static output), and deploys it.
  4. The resource’s dashboard card updates to show the new commit SHA and deployment status.
Auto-deploy is enabled by default. You can disable it on a per-resource basis from the resource’s settings panel if you prefer to trigger deploys manually or through the API.

Branch preview environments

Create a preview from a GitHub branch or commit for a supported web server, worker, or static website. A preview has separate resource state, but can inherit configuration that points at production dependencies. Review database URLs, queues, buckets, and credentials before deployment. Web-server and static-site previews have their own endpoints. Worker previews have no public URL. Branch tracking and deploy patterns determine which pushes trigger builds; do not assume a preview is created or isolated automatically on every push. See Preview environments for API creation, configuration, verification, and teardown.

Disconnect a GitHub installation

To remove a GitHub installation from Springwinter, you have two options: Via the API:
Via GitHub: Open GitHub.com → Settings → Applications → Installed GitHub Apps, find the Springwinter App, and click Configure → Uninstall. GitHub notifies Springwinter, which marks the installation as disconnected in your dashboard.
Removing a GitHub installation does not delete any deployed resources. Services currently running in your AWS account continue to run. However, auto-deploy stops working immediately — subsequent pushes will not trigger new builds until you reconnect a GitHub installation.

Multiple GitHub accounts and organizations

You can install the Springwinter GitHub App on multiple personal accounts and organizations. Each installation is tracked independently in Settings → Source control, and you can grant different repository subsets to each one. When adding a resource, you choose which installation to pull from, so you can deploy code from multiple organizations into the same Springwinter project.