Does Hodiploy support deployment via Git?

Yes, Git repository management is built into Hodiploy. It is even one of the most useful features for integrators who develop custom Odoo modules, since it lets you automate all or part of your releases. To see how the repository itself should be laid out (one module per folder, requirements.txt), see How should I organise my Git repository for Hodiploy?.

Two ways to connect a repository

When you create or edit an instance, the "GIT access" section offers a "Repository source":

• GitHub (recommended): you connect your GitHub account or organisation once, then pick a repository from a list. Nothing to configure on the repository side.
• Manual Git (SSH): for GitLab, Bitbucket, an internal Git server, or any repository you would rather not connect through GitHub. You manage the deploy key and the webhook yourself.

Option 1, GitHub, the simplest

1. Click "Connect GitHub", from the Hodiploy navigation bar or straight from the repository picker in the instance form
2. Install the Hodiploy App on your personal account or on your organisation, and choose which repositories it may read. You can allow just one and add others later
3. Back in the instance form, select the account, the repository, then the branch to deploy

That's it. There is no deploy key to add and no webhook to create: Hodiploy redeploys the instance on every push to the chosen branch, and clones your code read-only with a temporary token renewed at each deployment. No long-lived secret is left in your repository.

Option 2, manual Git over SSH

1. Enter your repository's SSH URL (for example git@github.com:group/project.git or ssh://git@gitlab.com:group/project.git)
2. Generate a dedicated SSH key with the matching button in Hodiploy, then copy the public key shown
3. Add that key to your repository, read-only. On GitHub that lives under "Settings", "Deploy keys", "Add deploy key". Other hosts have an equivalent screen
4. Test the connection from Hodiploy with the dedicated button, then select the Git branch to use
5. Generate the Webhook URL from Hodiploy
6. Add that webhook to your repository. On GitHub, "Settings", "Webhooks", "Add webhook", then paste the URL. Hodiploy accepts both the application/json and the application/x-www-form-urlencoded Content type, so you can leave GitHub's default

Note: if the webhook test fails before the instance exists, that is expected, the instance has to be created first.

What the webhook actually triggers

Every push to the configured branch deploys your code to the instance, with no action from you. Do not confuse this with the manual or automatic update option available elsewhere in Hodiploy: that one only concerns updating the Odoo version itself, not the deployment of your custom code.

What you see afterwards

• The branch and the date of the last Git deployment are shown in your instance list
• The instance's activity log records every push received, the redeployment it triggered, and its outcome
• The instance's logs tab shows each deployment step in detail

And when you duplicate an instance?

If the repository comes from your connected GitHub account, the copy follows the same repository and branch and redeploys itself on every push: nothing to do. With manual Git, the SSH key is reused but each instance needs its own webhook: Hodiploy shows you the URL to add when you duplicate.

Updated on: 26/08/2026