Skip to content

Commit d8c603a

Browse files
committed
TROUBLESHOOTING: introduce guide for common errors
Introduce a simple FAQ for common errors for people getting started with the project.
1 parent c5d8682 commit d8c603a

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

TROUBLESHOOTING.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
Troubleshooting libgit2 Problems
2+
================================
3+
4+
CMake Failures
5+
--------------
6+
7+
* **`Asked for OpenSSL TLS backend, but it wasn't found`**
8+
CMake cannot find your SSL/TLS libraries. By default, libgit2 always
9+
builds with HTTPS support, and you are encouraged to install the
10+
OpenSSL libraries for your system (eg, `apt-get install libssl-dev`).
11+
12+
For development, if you simply want to disable HTTPS support entirely,
13+
pass the `-DUSE_HTTPS=OFF` argument to `cmake` when configuring it.

0 commit comments

Comments
 (0)