Skip to main content
Version: 2.1.26

Git Deployment

Git Deployment (/git-deploy) publishes a website from a remote Git repository: fetch, check out, build, publish.

This is not a way to host repositories on this server. You name a remote the server can read — GitHub, GitLab, a self-hosted Gitea — and the panel gets that code onto the machine. Nothing accepts a push and nothing serves a repository.

Each site keeps its own deploy key. Show it, or replace it, from the page — the public half goes on the repository as a read-only deploy key.

Deployments can be triggered three ways:

  • by hand, from the page;
  • by a webhook the repository calls at /api/git-deploy/webhook/<user>/<domain>;
  • on a schedule, which asks the repository whether the branch has moved and deploys when it has.

The page shows the deployment history and the log of each run.

The same thing from a terminal:

hitechcloudcli gitdeploy-setup <user> <domain> --repo <url>
hitechcloudcli gitdeploy-deploy <user> <domain> [--commit <sha>]
hitechcloudcli gitdeploy-key <user> <domain> [--regenerate]
hitechcloudcli gitdeploy-list [<user>]
hitechcloudcli gitdeploy-poll [<user> <domain>]
hitechcloudcli gitdeploy-remove <user> <domain> [--purge]