1Frequently Asked Questions
 2==========================
 3
 4* I'm using the "scan-path" option, but cgit doesn't find my repo
 5
 6   * This is most likely due to permission problems: cgit usually runs under
 7     your webserver user account and will need read access to your repo (and
 8     all of the parent directories)
 9
10* My repo shows up in the list of repositories, but when clicking the
11  repo name, cgit complains that it's "Not a git repository"
12
13   * The most common cause of this is permission problems - see the previous
14     faq entry for more details.
15
16   * The second most common cause is that you've set repo.path to point
17     at the working-directory of your git repo - it should point at the
18     $GITDIR, i.e. the .git directory.
19
20   * A less likely cause is that the repo is, infact, not a valid repo. Try
21     to run a 'git show' in the offending repo to see if git also reports
22     about problems.