80

I'd like to know whether a remote repository exists. Here's what I came up with:

git ls-remote -h "$REPO_URL" &> /dev/null

Is there any better way?

  • 4
    It seems like a fine choice. The overhead of the “extra work” of fetching and formatting the list of refs (which is then sent to /dev/null) should be fairly small. – Chris Johnsen Dec 31 '10 at 0:57
  • The answer should be: No, there is no better way. – Timo Aug 18 '18 at 7:09
76

I think the git ls-remote command is pretty much made for that purpose.

| improve this answer | |
  • yep, this seems to work, but can you, please, provide some explanation and tell if this 100% that I can clone that repo – vladkras Oct 24 '16 at 9:32
17

If you use --exit-code argument you can skip sending output to null. It will return something only in case of error.

Also, you can use -h argument to show only heads references.

git ls-remote --exit-code -h "$REPO_URL"
| improve this answer | |
  • 1
    -h is a great idea. However, --exit-code is not the right choice here. The man page says: Exit with status "2" when no matching refs are found in the remote repository. This means that git ls-remote --exit-code "$REPO_URL" will fail for an empty repo that has only just been initialized with git init. – Jo Liss May 16 '15 at 22:20
3

You can narrow output by using something like git ls-remote "$REPO_URL" HEAD

| improve this answer | |
  • 1
    It hangs forever. – Timo Jul 18 '18 at 12:19
  • 1
    @Timo, then you probably have either unresponsive server or your connection or broken git client. For example network port is filtered. Further investigations is kinda similar to what happens when your ping doesn't respond :) . For example you can try check if you get connection established via netcat or openssl s_client or tracepath. – ony Aug 17 '18 at 5:29
1

TL;DR:

git ls-remote is the way, here is a shell-ready function for quick access:

  ## Returns errlvl 0 if $1 is a reachable git remote url 
  git-remote-url-reachable() {
      git ls-remote "$1" CHECK_GIT_REMOTE_URL_REACHABILITY >/dev/null 2>&1
  }

Usage:

if git-remote-url-reachable "$url"; then
   ## code
fi

What is it doing ?

This is just a convenient mash-up of all the comments/solutions previously stated with some small tweaks, a bash copy-paste ready function and usage code sample to make it crystal clear. You'll note that:

  • it limits output as the reference checked is probably nonexistent, as git will still exit with error-level 0 on non-matching ref. The only difference here is that there are slightly less output to transfer on the network compared to ask for HEAD (and much less than not asking for a ref or even limiting to only heads), and this is also less output to cast in /dev/null (but this last one is taking negligible time anyway)

  • the ref checked makes it clear we are probing for existence, this could help if you want to be polite with the administrators of the server you are probing and give them a chance to understand why they receive these probes if they monitor anything.

| improve this answer | |
  • 1
    as long as you're using bash, this is syntax is a little cleaner: &>/dev/null – Chris Noe Apr 1 at 12:29

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

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