From dc6f7a345acceefa6b74e91bcf8b46f3d8245c71 Mon Sep 17 00:00:00 2001 From: Lars Hjemli Date: Sat, 18 Jun 2011 13:47:20 +0000 Subject: faq: add entries for permission-related problems Signed-off-by: Lars Hjemli --- faq | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/faq b/faq index bba144d..3fb623d 100644 --- a/faq +++ b/faq @@ -1,4 +1,22 @@ Frequently Asked Questions ========================== -(Coming soon) +* I'm using the "scan-path" option, but cgit doesn't find my repo + + * This is most likely due to permission problems: cgit usually runs under + your webserver user account and will need read access to your repo (and + all of the parent directories) + +* My repo shows up in the list of repositories, but when clicking the + repo name, cgit complains that it's "Not a git repository" + + * The most common cause of this is permission problems - see the previous + faq entry for more details. + + * The second most common cause is that you've set repo.path to point + at the working-directory of your git repo - it should point at the + $GITDIR, i.e. the .git directory. + + * A less likely cause is that the repo is, infact, not a valid repo. Try + to run a 'git show' in the offending repo to see if git also reports + about problems. -- cgit v1.2.3-18-g5258