Connect a GitHub repository to your app, then deploy it with one click whenever you are ready.
Automatic deploy on every push is not available at the moment. Pushing to GitHub does not start a deploy by itself. Click Deploy Now after you push, or deploy from your CI with a deploy token (below). That gives you deploy-on-push today, from GitHub Actions, GitLab CI or Bitbucket Pipelines.
Connect your repository
- Open your app and go to Access › GitHub
- Enter your repository URL, for example
https://github.com/username/repo - Choose the branch to deploy from (usually
main) - Click Connect Repository
A public repository needs nothing further. For a private repository, also paste a GitHub personal access token with repo scope in the Access token field. It is stored encrypted and never shown again; you can replace or remove it from the same tab.
Deploying
Click Deploy Now. We pull the branch you chose, build it and start it. If a build fails, the version that was already running keeps running.
Deploy on every push, using your CI
- Create a token under Access › Deploy Tokens
- Add it to your CI as a secret
- Copy the ready-made GitHub Actions, GitLab CI or Bitbucket Pipelines example from the same tab
Your CI then uploads your code on each push and the app deploys.
Build logs
Open the Deploy section of your app to see each deployment and its build output. If a deploy fails, the log is the first place to look.
Disconnecting
Click Disconnect in the GitHub tab. Your app keeps running exactly as it is.