Deploy from GitHub
A GitHub connection keeps GitHub as the source of truth while Tokay follows the selected branch and prepares each new commit. The Project's When you push setting decides whether the update goes live automatically, runs in a preview first, or waits for you.
Last updated
AI agent? Start with llms.txt.
Connect the repository
- From Add code, choose GitHub.
- The first time, choose Install GitHub App for durable team access, or Use your GitHub account when you cannot install apps on the account that owns the repository.
- Choose the account that owns the repository, then the repository. If it is not listed, choose Add it on GitHub to give the GitHub App that repository, or Request access on GitHub when an organization needs to approve your personal access. For a repository under an account you haven't connected, choose Add a GitHub account or organization.
- Tokay synchronizes the repository's default branch and detects the Services it can run.
- Review the detected setup and deploy the Service you want.
Each Service follows its selected branch. Change it in Service Settings between builds and deployments; the running app stays up. Commits to branches no Service follows do not deploy.
GitHub stays in control of the code
Continue editing locally or on GitHub, or use Tokay’s source editor to create a pull request. The PR targets the selected branch and must be merged on GitHub before it deploys.
Tokay caches the default and selected branches for builds and deployment. A clone of that cache is not a full copy of every upstream branch and tag. Deploying needs only read access. To open pull requests from Tokay, enable pull requests for the repository or use a GitHub account that can push to it. GitHub notifies Tokay when a commit arrives, and Tokay also checks for updates so a missed notification delays a deploy rather than losing it.
Disconnect without taking the app down
Disconnecting stops the GitHub relationship but does not stop the running Services. Tokay keeps the code it already has as hosted code, and the repository on GitHub is unchanged.
See Editing your code for the shared commit and pull-request workflow.