Skip to content

Auto-Deploy

Enable automated deployments so your application rebuilds when you push to the selected GitHub branch.

How it works

Docklift registers for GitHub push webhooks. When you push to the branch configured on the project, GitHub notifies your Docklift instance. Docklift verifies the webhook secret, applies a short 10 second debounce (so burst pushes collapse into one deploy), then triggers a fresh deployment.

Auto-deployments appear in deployment history with a webhook trigger for auditing.

Enable

  1. Open the project
  2. Go to the Source configuration tab
  3. Toggle Auto-Deploy to ON

Requires a GitHub-connected project (or equivalent webhook-capable source). Private GitHub App installs configure webhook delivery for you.

Security

When Auto-Deploy is enabled, Docklift generates a webhook secret. Incoming requests must present a valid signature so arbitrary callers cannot trigger builds.

With the recommended private GitHub App flow, Docklift manages secret creation and verification automatically. Do not expose unsigned deploy endpoints.

Behaviour notes

  • Only pushes to the project's selected branch trigger a deploy
  • Debounce: rapid successive pushes within ~10s coalesce into one build
  • If a deployment is already running, wait or cancel it first — deployments are serialized per project
  • Cancel mid-build tears containers down for a clean retry; past history entries are not rewritten

Disable

Turn Auto-Deploy off on the Source tab. Manual Deploy / Redeploy still work from the dashboard.

Open-source self-hosted PaaS for Docker