git clone fails: Unable to find remote helper for 'https'
fatal: Unable to find remote helper for 'https'Short answer
Git handles https through a helper program named git-remote-https, which is built with curl support. If git was compiled without the curl development files, that helper is missing. A mistyped scheme in the URL gives the same message. Fix the URL, or install curl headers and rebuild git.
Fix it fast
1Find out which cause you have
Look at the URL scheme you typed, then list the remote helpers next to git's core programs. If git-remote-https is not in the list, the helper is missing.
git remote -v ls "$(git --exec-path)" | grep remote2Match what you see, then jump to its fix
What does the error look like?
fatal: Unable to find remote helper for 'https'
Cause 1 of 2
git was built from source without curl support
1Check
Git ships a curl family of helpers, including git-remote-http and git-remote-https, to handle http transports. Building from source needs curl among its required libraries.
git --version
which -a git2Fix
Install the build dependencies from the Git book, rebuild and reinstall git. On Debian or Ubuntu that list includes libcurl4-gnutls-dev.
sudo apt-get install dh-autoreconf libcurl4-gnutls-dev libexpat1-dev gettext libz-dev libssl-dev
make configure
./configure --prefix=/usr
make all
sudo make install3Verify
git-remote-https is now listed, and a clone works.
ls "$(git --exec-path)" | grep remote
git clone https://github.com/git/git.gitConfirmed by git-scm.com
Cause 2 of 2
The URL scheme is mistyped
1Check
When a URL uses a transport Git cannot handle itself, Git invokes git remote-<transport> for it. A scheme such as htps or http s has no helper, so the lookup fails.
git remote -v2Fix
Correct the URL and clone again.
git remote set-url origin https://example.com/team/repo.git
git clone https://example.com/team/repo.git3Verify
The clone starts transferring.
git ls-remote https://example.com/team/repo.gitConfirmed by git-scm.com
How do I stop it coming back?
- Install git from your distribution's package manager unless you need a newer version.
- When you build git, keep the dependency list of the Git book in your build script.
- Copy clone URLs from the hosting site rather than typing them.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.
Which stack is behind this page?
Related fixes
Servers
dnf cannot install MySQL on Amazon Linux 2023
dnf cannot find a mysql-server package on Amazon Linux 2023
Amazon Linux 2023 documents MariaDB, not MySQL, as its database server, with packages named mariadb105 and mariadb105-server.
3 causes, each with a fixServers
Ansible hangs, then times out waiting for the sudo prompt
a playbook using become seems to hang
Ansible ran sudo on the target and never saw the answer it expected.
3 causes, each with a fixServers
Apache on Ubuntu returns 404 Not Found for my site
The requested URL was not found on this server.
On Ubuntu a 404 from Apache usually means the request maps to a path that has no file.
3 causes, each with a fixServers
Apache returns 504 Gateway Timeout when PHP takes too long
Quick requests work, slow ones end in a 504 after a fixed wait
A 504 from Apache means the backend did not answer within the proxy timeout.
2 causes, each with a fixServers
Apache logs SIGWINCH and exits on its own
the httpd container stops although nothing crashed
SIGWINCH is Apache's graceful-stop signal.
2 causes, each with a fixServers
Apache warns that a ${VAR} config variable is not defined
${VAR} left unchanged in the configuration, with a warning in the error log
Apache expands ${VAR} from Define or from the shell environment that exists when the server starts.
3 causes, each with a fix