Connect a Git repository
A project is one Odoo codebase: an Odoo version, the repository with your modules, and the environments that run it.
1. Create a project
Section titled “1. Create a project”- Open Projects and press New project.
- Enter a Name (lowercase letters, digits,
-and_, for exampleshop-erp), an optional Description, and choose the Odoo version. - Create it. The project’s page opens.
2. For a private repository: add a Git connection
Section titled “2. For a private repository: add a Git connection”A public repository needs no connection. Skip to step 3.
- Open Settings → Git connections and press Add a Git connection.
- Choose the Provider: GitHub, GitLab, or Other / self-hosted for any Git host that works over HTTPS.
- Enter a Name (for example
company GitHub) and the Access token: a token that can read the repositories. Some Git servers also need the Username the token belongs to. - Press Add connection.
The token is checked with the provider at once, stored encrypted, and never shown again.
3. Set the main repository
Section titled “3. Set the main repository”- On the project’s page, open the Repositories tab.
- Press Set the main repository.
- Enter the Repository URL, for example
https://github.com/you/repo.git. - Choose the Git connection, or None (a public repository).
- Press Load branches and choose the Branch. Without loading the branches, the repository’s default branch is used.
- Save.
The platform reads the repository’s branches right away, so a wrong address or a token without access is reported here, not at the first deploy.

