32

The Question

How to add existing sub repository as a submodule in git?

The Why

I have a private codespace supermodule with submodules scattered randomly:

codespace (git repo, private)
├── Archived_projects (git repos)
└── Projects
    ├── project-foo (git repo)
    └── project-bar (git repo)

Sometimes submodules have commits not ready to be pushed. But I want them to be saved while pushing supermodule codespace.
codespace is a repo cloned to c9.io workspace or other places.

What I Do

linus@machine /cygdrive/f/__Storage__/Workspace
$ git clone https://github.com/octocat/Spoon-Knife.git
Cloning into 'Spoon-Knife'...
$ cd Spoon-Knife/
$ git clone https://github.com/octocat/Spoon-Knife.git ./foo/bar
Cloning into './foo/bar'...
$ git add .

From cmd.exe

> git submodule add https://github.com/octocat/Spoon-Knife.git ./foo/bar
'foo/bar' already exists in the index
> cat .gitmodules
cat: .gitmodules: No such file or directory

From cygwin.exe (bash)

$ git submodule add https://github.com/octocat/Spoon-Knife.git ./foo/bar
': not a valid identifier/Git/mingw64/bin/gettext.sh: line 89: export: `sm_path
'' already exists in the index
$ cat .gitmodules
cat: .gitmodules: No such file or directory

Reference

git submodule [--quiet] add [-b <branch>] [-f|--force] [--name <name>]
              [--reference <repository>] [--depth <depth>] [--] <repository> [<path>]

<repository> is the URL of the new submodule’s origin repository.

<path> is the relative location for the cloned submodule to exist in the superproject. If <path> does not exist, then the
submodule is created by cloning from the named URL. If <path> does exist and is already a valid Git repository, then this is
added to the changeset without cloning. This second form is provided to ease creating a new submodule from scratch, and
presumes the user will later push the submodule to the given URL.

In either case, the given URL is recorded into .gitmodules for use by subsequent users cloning the superproject. If the URL
is given relative to the superproject’s repository, the presumption is the superproject and submodule repositories will be
kept together in the same relative location, and only the superproject’s URL needs to be provided: git-submodule will
correctly locate the submodule using the relative URL in .gitmodules.

If <path> does exist and is already a valid Git repository, then this is added to the changeset without cloning.

Why this doesn't work in my case?

1
  • This might help. Move the repo out of your worktree, submodule add that, fix up the urls
    – jthill
    Commented Sep 26, 2015 at 7:05

8 Answers 8

36

What went wrong

Where you went wrong is doing the

$ git add .

That adds everything, so also foo/bar, to the index of the current repository (ready to be committed thus).

Correct way

If you just don't do that and continue with

$ git submodule add https://github.com/CarloWood/XYZ.git foo/bar

then that should work; this would detect that foo/bar is an already cloned repository and add it to the current repository as a submodule.

Note that it is not needed to clone first. You explicitly say you already have done that, but for clarity for other readers I'd like to point out that if you omit the clone right before the git add . too (so there isn't a foo/bar at all now) then the above git submodule add ... would see there isn't anything yet and then simply clone it for you.

Note that there is a minor difference between methods. If you start with cloning then foo/.git will be a directory, while if you use git submodule add to do the cloning then this .git repository is put in .git/modules/foo of the parent project and foo/.git is a file containing the path to that. There is no real difference however as using a file for the .git to point anywhere else is generic and could be used anywhere; you can not conclude anything from .git being a file or directory.

1
  • Thanks. I added it 5 years after it was asked - so it's not that strange they aren't monitoring it anymore :D. Hell maybe @ilyaigpetrov has deceased in the meantime!
    – Carlo Wood
    Commented Feb 25, 2022 at 18:36
10

One way to do it is to manually create the .gitmodules file.

The format is below:

[submodule "path/to/submodule1"]
    path = path/to/submodule/1
    url = [email protected]:user/submodule1
[submodule "path/to/submodule2"]
    path = path/to/submodule/2
    url = [email protected]:user/submodule2

Note you'll have to run

git submodule sync

to apply the changes

4
  • 1
    Note, it's .gitmodules.
    – Tom
    Commented Mar 14, 2019 at 10:09
  • Unfortunately this doesn't seem to do anything.
    – DustWolf
    Commented Jul 22, 2020 at 14:34
  • 1
    @DustWolf you need to run git submodule sync for the changes to be applied
    – Rufus
    Commented Jul 25, 2020 at 10:44
  • @Rufus I haven't tried but it sounds like it might. I ended up using this solution: stackoverflow.com/a/30675130/2897386 ...which seems safer.
    – DustWolf
    Commented Jul 29, 2020 at 13:42
7

git submodule add detects if the path given for a submosule exists and contains an initialized git repo, so no neeed to worry about that. I ran into a similar problem so I wrote a (hacky) script to deal with this issue.

#!/bin/bash
# save super directory
currentDir=`pwd`
# get all the git repos inside (except .) and format them 
# the way git does
gitDirs=`find -type d -name ".git" | sed -e 's|.git$||' -e 's|./||' -e 's|/$||' | grep -v "^$"`

for i in ${gitDirs[@]}
do
        echo "dealing with $i now"

        cd $i 
        # get the remote url for each submodule
        fetchUrl=`git remote -v | awk '/fetch/ {print $2}'`
        # for my purposes repos without remotes are useless
        # but you may have a different use case
        if [[ -z $fetchUrl ]]
        then
                echo "fetch url not found for this directory"
                continue
        else                                                      
                echo "got a fetch url of $fetchUrl for git repo $i"                                                                 
        fi                                                        

        cd $currentDir
        # make sure it isn't tracked as a submodule already                                                         
        existing=`grep -A5  $i ./.gitmodules | grep $fetchUrl`    

        if [[ -z $existing ]]                                     
        then                                                      
                echo "does not exist in .gitmodules yet, will create now"
                # if it doesn't exist yet then create it
                git submodule add $fetchUrl $i
        else
                echo "$i is already present as a submodule with fetch url: $fetchUrl"
                echo "The command we would have used is: git submodule add $fetchUrl $i"
        fi
done

6

Don't add the submodule using git add, use git submodule add

git submodule [--quiet] add [<options>] [--] <repository> [<path>]

If you've already cloned the repository, just run

git submodule add -- "$(git -C ./sub/ remote get-url origin)" ./sub/

NB: The relative path prefix, ./, is important here ... unless you are specifying an absolute path.

Alternatively

git submodule add -- ./sub.git ./sub

if the project is using relative URLs.

2
  • It is important to note that this will add a submodule that literally points to the local working copy, and not to its remote. You can see this for yourself by looking inside the updated .gitmodules file. Commented Dec 4, 2022 at 15:24
  • True, the local repo is added as the repo. To change it after the fact change such configuration using git submodule set-url -- sub "$(git -C ./sub/ remote get-url origin)".
    – CervEd
    Commented Dec 5, 2022 at 10:28
4

To augment Carlos Answer, for an existing repo. It already contains its URL. You can simply

 git submodule add $(cat repodir/.git/config  | grep url | cut -d '=' -f 2) reponame
3
  • 2
    Maybe instead of parsing the config file yourself, you could use git config, to read the url: git submodule add $(git -C repodir config remote.$(git -C repodir config branch.master.remote).url) repodir. This selects the url of the remote tracking branch of the master branch. (Works even if multiple remotes exist, your example doesn't work in that case.) (git -C somedirectory means, that git behaves as if started from within somedirectory)
    – T S
    Commented Jun 18, 2021 at 10:54
  • unnecessarily complex, git -C sub/ remote get-url origin | xargs -I% git submodule add % ./sub/
    – CervEd
    Commented Apr 5, 2022 at 10:36
  • even easier, git submodule add ./sub/, NB ./
    – CervEd
    Commented Apr 5, 2022 at 10:44
2
  1. remove files from index foo/bar: git rm -f --cached foo/bar
  2. git submodule add https://github.com/octocat/Spoon-Knife.git ./foo/bar
0

At least if the (future) submodules do not have recursive other repositories/.git directories then the following simply adds all of them. (I am not sure why I had to supply the directory as path and "repository" to the command but whatever...)

for d in $(dirname $(find -mindepth 2 -name .git)) ; do git submodule add -- ./$d/ ./$d/ ; done
-3

You don't need to clone manually first. After running git submodule add [url] [path] run git submodule update, which will clone/pull all submodules for you.

2
  • I have repository with cloned and modified data already. Ideally I would like to be able to push submodules with supermodule to the server. Well, if it is not possible, I accept your answer. Commented Sep 25, 2015 at 9:25
  • I've got same question, already cloned, and modified some files, how to add this modified repo as submodule to another git repo? Commented Feb 28, 2020 at 7:17

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.