Deploy from GitHub

Connect a GitHub repo to a service and 5050cloud builds and deploys every push to its branch.

Public repos

Public repos need no setup.

1. On the canvas, select + Create, then GitHub repo.
2. Paste the repo URL, for example https://github.com/owner/name.
3. Review the scan: Dockerfile or Railpack, config files found, suggested port and variable names from .env.example files.
4. Select Deploy Now, or Add Variables to stage the service and set variables first.

Automatic deploys for public repos poll the branch every 2 minutes.

Private repos and push webhooks

Private repos need a GitHub App, which 5050cloud creates for you:

1. Go to Settings > GitHub and select Create GitHub App. GitHub asks you to confirm; no keys are copied by hand.
2. Select Install and pick the repos the app may read.
3. Repo pickers now list those repos. Pushes reach 5050cloud through the app's webhook and deploy at once.

Any repo picker also offers Connect GitHub when no app exists yet, and keeps what you typed while you connect.

The app asks for read access to contents, metadata, pull requests and checks, and the push event.

Branch and root directory

In Settings > Source, set Branch (default: the repo's default branch) and Root directory for monorepos. See Monorepos and watch paths.

How the build is chosen

• A Dockerfile in the root directory is used when present.
• Otherwise Railpack detects the language and builds an image.
• A railway.json, railway.toml, 5050.yaml or 5050.json file overrides settings. See Config as code.

Next steps

• Variables and references
• Custom domains and HTTPS
• Troubleshooting failed deploys