Deploying from GitHub Repository

This guide walks you through creating a deployment in XO Launchpad using a GitHub repository.

Prerequisites

Environment Variables — Set up required ENV_VARS as GitHub repository secrets before deploying.

Go to your repository on GitHub: Settings → Secrets and variables → Actions → New repository secret

Add each environment variable (e.g. DATABASE_URL, API_KEY, JWT_SECRET) inside the ENV_VARS secret.

Dockerfile — Your repository must include a valid Dockerfile at the project root. Without it, your build will fail.

From the sidebar, go to Create from blank.

Under Create New Deployment, select GitHub Repository.

Fill out the form:

Repository URL — Format: https://github.com/username/repo-name
Branch Name — The branch to deploy. Default: main
GitHub Access Token — Generate a Personal Access Token (PAT) with repo and workflow scopes.

To generate a PAT: GitHub Developer Settings → Tokens → New token. Select repo and workflow scopes.

Without the correct PAT scopes, deployments will fail.

Project Name — Unique name (lowercase letters, numbers, hyphens only). Example: project-07
Instance Size — Choose based on resource needs.

Review your settings and click Create Deployment. XO will pull the repository, build, and deploy your app.

Cause	Fix
Missing Dockerfile	Add a valid `Dockerfile` at the repository root
Clicked too soon (build in progress)	Wait until logs show "container running" before visiting the URL
Wrong port configured	Open Actions → Update Port and enter the correct port
App crash on startup	Check deployment logs, fix errors, redeploy
Missing environment variables	Verify all required vars are added as repository secrets
Browser cache	Hard reload with `Ctrl + Shift + R` or open in incognito