Trigger a Manual Deployment

Use this guide when you want to deploy without pushing to a mapped branch. A manual deployment lets you start a build on demand — either by uploading a local folder or by deploying a branch from a connected GitHub repository.

Before You Begin

• A project with at least one environment.
• The code you want to deploy, either as a local folder or in a connected GitHub repository.

Manual deployments complement GitHub continuous deployment. You can use both on the same project: push to a mapped branch for automatic deploys, and trigger a manual deployment whenever you need an off-cycle build.

When to Use a Manual Deployment

Most teams rely on automatic deployments triggered by pushes to a mapped branch. Trigger a manual deployment when you want to:

• Deploy local changes that you have not pushed to GitHub yet.
• Deploy a branch on demand, without configuring a branch mapping.
• Re-run a build for an existing branch
• Deploy a project that is not connected to GitHub at all, using a folder upload.

Open the Deployment Dialog

1. Open your project in the dashboard.
2. Scroll to the Recent Deployments section.
3. Click New Deployment.

The Deploy Code dialog opens with two tabs: File Upload and GitHub Repo. Choose the path that fits your source code.

Option A: Deploy from a Local Folder

Use this path to deploy code straight from your machine. No GitHub connection is required.

1. In the Deploy Code dialog, select the File Upload tab.
2. Click Choose Folder and select the folder that contains your project.
3. Select the target Environment from the dropdown.
4. Leave Set as current deployment checked to route the environment's traffic to this deployment once it succeeds. Uncheck it to build the deployment without changing which deployment currently serves traffic. See Set as the Current Deployment.
5. Click Deploy.

Option B: Deploy from a Connected GitHub Repository

Use this path to deploy a specific branch on demand. This path requires a connected GitHub repository.

1. In the Deploy Code dialog, select the GitHub Repo tab.
2. Confirm the connected repository shown at the top of the tab (Deploy from connected repo: owner/repo).
3. Select the target Environment from the dropdown.
4. Select the Branch to deploy. The list is populated with the branches in your connected repository; the default branch is preselected.
5. Leave Set as current deployment checked to route traffic to this deployment once it succeeds, or uncheck it to build without changing the current deployment.
6. Click Deploy from GitHub.

If No Repository Is Connected

If the project has no connected GitHub repository, the GitHub Repo tab shows No GitHub repository connected. Click Open Project Settings to connect one, then return to this dialog. See Set Up GitHub Continuous Deployment.