If your GitHub Enterprise Pages code includes a reference to an invalid submodule, your GitHub Enterprise Pages site will not be built.

If your GitHub Enterprise Pages site fails to build because of an invalid submodule, you'll get an email with this message:

Subject: Page build failed

The page build failed with the following error:

"The submodule registered for `./EXAMPLE_SUBMODULE` could not be cloned. Make sure it's using https:// and that it's a public repo.

You will only receive an email if outbound email support is enabled on your Enterprise instance. For more information, contact your site administrator.

Troubleshooting invalid submodule errors

We strongly recommend running Jekyll locally so you can easily debug and fix build errors before pushing to your GitHub Enterprise instance.

Check the submodule referenced in the build failure email. Ensure that:

  • You use https:// when referencing the submodule, not http://.
  • The submodule is in a public repository. The GitHub Enterprise Pages server cannot build from submodules in private repositories.

Once you've fixed all invalid submodule errors, you will need to commit your changes and push to your GitHub Enterprise Pages repository again to trigger another build on the server.