Sign Up
Docs Deploy from GitHub

Deploy from GitHub

Connect your repository and enable continuous deployment. Every push can automatically build and deploy to production.

Connecting your Account

To get started, link your GitHub account to RunxBuild. This allows us to securely:

  • List and import your repositories
  • Create webhooks for automatic deployments on push
  • Report build and deployment status back to GitHub

Permissions: RunxBuild only requests the minimum access required to build and deploy your code.

How Deployment Works

Once connected, deployments are fully automated. RunxBuild pulls your latest commit, runs your build, and updates the live service.

Push to Deploy

Every push to your selected branch triggers a new build and deployment automatically.

Zero-Downtime Updates

Deployments use rolling updates so your service stays online while the new version comes up.

Instant Rollbacks

If something breaks, you can roll back to a previous deployment from the dashboard in seconds.

Branch Configuration

Choose which branch should deploy to production. Most teams use main or master. You can change this later without re-importing the repo.

Common Setup:

Production branch: main
Auto deploy: enabled
Deploy on push: enabled

Security

Your connection is secured end-to-end. RunxBuild never exposes your repository secrets, and environment variables are stored encrypted.

Encrypted Secrets

Environment variables and tokens are encrypted at rest and only injected at runtime.

Troubleshooting

If a deployment fails, the first place to check is your build logs. Common issues include missing build commands, incorrect output folders for static sites, or apps not listening on the required PORT.

  • Open your service → Deployments → click the latest deploy to view logs
  • Confirm your build and start commands are correct
  • For web services, confirm your app listens on PORT