cgit/faq

Frequently Asked Questions
--------------------------

This is a compilation of frequently asked questions on the cgit mailing
list. If you've got a cgit problem and cannot find an answer here, please
send a request to cgit@lists.zx2c4.com (and consider sending a patch to the
cgit wiki branch to update this faq if you get a nice answer to your
question). The project also maintains the #cgit channel on Libera.Chat.

### Why doesn't cgit find/show my repo?

This is most likely due to permission problems: cgit runs under your
webserver user account and will need read access to your repo (and all
of the parent directories)


### Why does cgit complain that my repo is "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 'git show' in the offending repo to see if git also thinks your
repo has issues.


### Why is the idle time for my repository wrong?

By default CGit uses the modification time of the default branch's ref
file as a quick method of determining when the repository was last
changed.  If you primarily work on other branches then this work will
not be reflected in the idle time.

You can use a post-receive hook to run a script that tells CGit the
correct modification time by writing to ``info/web/last-modified``.  An
example is provided in the CGit repository at
``contrib/hooks/post-receive.agefile``.