+++
title = "Change git submodule URL"
aliases = '/posts/2022-11-26-change-git-submodule-url'
summary = """Another thing I forget constantly when using git:
Changing the remote URL of a submodule"""
date = "2022-12-01T20:08:17+01:00"
lastmod = '2024-09-28T23:48:06+0000'
categories = ["computerstuff"]
tags = ["git"]

+++

If the location (URL) of the submodule has changed, then you can simply:

1. Modify the <kbd>.gitmodules</kbd> file in the repo root to use the new URL.
2. Delete the submodule folder in the repo

   ```console
   $ rm -rf .git/modules/<submodule>
   ```

3. Delete the submodule folder in the working directory

   ```console
   $ rm -rf <submodule>
   ```

4. Run

   ```console
   $ git submodule sync
   ```

5. And run

   ```console
   $ git submodule update
   ```

More complete info can be found elsewhere:

<https://stackoverflow.com/questions/913701/changing-remote-repository-for-a-git-submodule>