I recently set up a new Cygwin environment to test and document the process of cloning and using one of the OpenXC repositories from GitHub in Windows, since this is a very popular platform for many users. Unfortunately many people were being blocked at the very first step, just attempting to clone the repository.
GitHub transitioned a little while back to using Smart HTTP by default for all public repositories. This is great because even for folks that need to commit to repositories, they can skip the SSH key dance if they aren’t already using that in their daily routine. This seems to be especially the case for Windows users.
So for OpenXC, a new users installs Cygwin with the “git” package and attempts to clone the repository, and it explodes:
I was able to figure out which library was missing by using
This tells me that
libsasl2 is missing, so install that from the Cygwin
Try the clone again and it still fails:
By default, Cygwin doesn’t have the CA root certificates installed, so
nothing using SSL will work properly. Install the
to install those.
This problem was a little difficult to debug because I don’t think very many
people encounter it. Typically when someone installs Cygwin, they also install a
base set of packages that includes things like
curl. Well, one of the
package’s many dependencies are both
explains why many people do not encounter this problem.