Documentation

features

GitHub Integration

Connect GitHub for push-to-deploy, branch previews, and repository management.

GitHub Integration#

Connect your GitHub account to deploy directly from your repositories. Every push to your configured branch automatically triggers a new deployment.

Setting up#

The easiest way. Click "Sign in with GitHub" on the login page. Runix gets access to your public and private repos automatically.

Push-to-deploy#

Once you deploy a repo, Runix attempts to register a webhook on that GitHub repository. Every push to the tracked branch (usually main) triggers automatic rebuild/redeploy for all matching services on that repo+branch.

That's it — just push

bash
git push origin main
# Runix automatically detects the push and starts rebuilding

Push-to-deploy is strictly branch-scoped. Pushes to other branches are ignored for that deployment. Pull request events update preview metadata when preview environments are enabled.

Preview environments#

On Pro and Business plans, you can deploy from any branch to create preview environments. This is useful for testing pull requests before merging.

  • Each branch gets its own URL (e.g., feature-auth-x7kf.runixcloud.dev)
  • Preview deployments are independent from your main deployment
  • Delete the preview when the branch is merged

Repository access#

Runix can access your public and private GitHub repositories. You can browse and select repos directly from the dashboard when creating a new deployment.

Runix only reads your code to build it. We do not modify your repositories, create branches, or push commits.