+++
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 = '2023-11-18T22:01:29+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>