Push to deploy

With push to deploy, every push to your chosen branch deploys that exact commit. GitHub shows the deployment status on the commit. DockHive sets up the webhook for you.

Turn it on

1. Open your app and go to Builds & Settings → GitHub Auto-Deploy.
2. Pick the Branch (it defaults to the app’s branch) and click Save branch.
3. Switch on Auto-deploy on push.

You’ll see “Pushes to <branch> now deploy automatically.”

Requirements

• The repository is on github.com.
• Your GitHub connection has repository and webhook access, and you’re an admin of the repository. If not, the console shows a Reconnect GitHub link; reconnect and grant access.
• Apps deployed from a folder can’t use push to deploy.

What deploys

• Only pushes to the selected branch. Tags, other branches and branch deletions are ignored.
• If a deploy is already running, the next push waits and deploys when it finishes. If several pushes arrive meanwhile, the latest one wins.

The settings card shows the webhook status and the Last delivery, for example deploying abc1234 as v7 or ignored: push to feature-x, auto-deploy branch is main.

Require approval

In a team workspace you can make pushes wait for a person to approve them. In Builds & Settings, turn on approval and set Requests expire after (hours) (1 to 720, 72 by default). “Pushes now wait for an owner or admin to approve them.”

When a push arrives:

1. A deployment is created for that exact commit and waits. Nothing is built yet, and GitHub shows the commit as pending.
2. The app page shows a banner: “A workspace owner or admin must approve it.”
3. An owner or admin clicks Approve or Reject, with an optional note. Approved deployments build and go live as usual.

A newer push replaces a waiting one. A request that isn’t decided in time expires, and you can push again.

While approval is on, developers can’t deploy any other way: new images wait for approval too, and redeploys, rollbacks and changes to settings, environment variables or registry logins are refused. Owners and admins deploy directly. Each deployment records who asked, who decided, when, and the note.

Status on GitHub

Each commit gets a DockHive status that links to the deployment in the console:

• pending: Deploying v7
• success: v7 is live
• failure: v7 failed while building (or another stage)

Turn it off

Switch off Auto-deploy on push. DockHive removes the webhook from GitHub. Changing the app’s repository or deleting the app also turns it off.