Deploy from GitHub

The console’s new-app wizard has four steps: Select Repository, Choose Framework, Domain & Region and Configure & Deploy.

1. Connect GitHub and select a repository

Open App Hosting in the console and start a new app. Under Git Provider, click Connect GitHub.

DockHive asks GitHub for access to:

• your profile and email address,
• your repositories, including private ones (repo), so it can read your code and post deployment status on your commits,
• repository webhooks (admin:repo_hook), so push to deploy can set itself up.

If you signed in to DockHive with GitHub, you may see Repository access not granted. Click Grant repository access to use private repositories and push to deploy.

Then search for your repository and pick it. Private repositories have a Private badge.

Public repositories

No GitHub connection needed: switch to the Public Repository tab, paste the repository’s https:// URL (GitHub, GitLab or Bitbucket) and enter the branch name.

To use a different GitHub account, click Disconnect, revoke DockHive’s access on GitHub, then connect again. Manage Access opens your GitHub settings.

2. Choose a build mode

Click Deploy with Drone to let Drone handle everything, or pick a framework preset. The wizard detects your framework and tells you what it found. See Drone and frameworks.

3. Domain and region

• Custom Domain (optional): you can add one now or later. Your app always gets a free address. See Custom domains.
• Deployment Region: choose a region close to your users. See Regions.

4. Configure and deploy

• Project Name: becomes the app’s id: lowercase letters, digits and -, up to 40 characters. It must be unique in your account.
• Branch: defaults to the repository’s default branch.
• Advanced Settings:
  • Root Directory: the folder that contains your app, relative to the repository root (for example apps/web in a monorepo). Leave it as ./ for the repository root.
  • For framework presets only: install, build and start commands, and the port your app listens on (leave empty to auto-detect).
  • Environment Variables: one KEY=value per line. See Environment variables.

Click Deploy. The console streams the build log while it works. When the status reads Live, open your app’s address.

Check before you deploy

With Drone selected, Check my code lets Drone look at your code first and tell you which settings (such as environment variables) your app needs. This is optional.

Private repositories you can’t reach with your GitHub account

If the repository belongs to an account your GitHub connection can’t read, add a Repository Access Token in the app’s Builds & Settings. It is stored encrypted and never shown again.