Using Git submodules

Clone submodules during deployment allows you to use submodules in your Git repository. They are usually listed in a .gitmodules file at the root of your Git repository. When you push via Git, will try to clone them automatically.

Here is an example of a .gitmodules file:

[submodule "app/Oro"]
    path = src/Oro
    url =
[submodule "src/OroPackages/src/Oro/Bundle/EntitySerializedFieldsBundle"]
    path = src/OroPackages/src/Oro/Bundle/EntitySerializedFieldsBundle
    url =
[submodule "src/OroB2B"]
    path = src/OroB2B
    url =

When you run git push, you can see the output of the log:

Validating submodules.
  Updated submodule git:// 4 references updated.
  Updated submodule git:// 229 references updated.
  Updated submodule git:// 11 references updated.

Error when validating submodules

If you see the following error:

Validating submodules.
  Found unresolvable links, updating submodules.

E: Error validating submodules in tree:
    - /src/Oro: Exception: commit 03567c6 not found.

   This might be due to the following errors fetching submodules:
    - HangupException: The remote server unexpectedly closed the connection.

Since the Git server cannot connect to Github via SSH without being granted an SSH key to do so, you should not be using an SSH URL:, but you should use an HTTPS URL instead: