[Idea] A local cgit configuration per project?

John Keeping john at keeping.me.uk
Thu Apr 30 15:06:18 CEST 2015

On Thu, Apr 30, 2015 at 02:57:22PM +0200, Vincent Férotin wrote:
> As a newbie to cgit, I'm currently trying to configure it for a a
> project which hosts some git repos.
> It seems to me (please refute me if I'm wrong) that cgit takes its
> configuration from a given hard-coded path, i.e. "/etc/cgitrc".
> This mean that basically there should only be one instance of cgit per system.
> I wonder if it is feasible that cgit would take its *main*
> configuration from "/etc/cgitrc",
> but also would override it from a *local* one, e.g. a given
> configuration from a project
> (typically per Apache virtual host)?
> Perhaps this could be "easily" achieved either by wrapping cgit CGI in
> an other dedicated script,
> setting a project's environment, or by cgit searching for additional
> config. pointed by an environment variable, or else through argument
> on command-line?
> If this is already achievable, could you please point me to some
> related documentation?

You can set CGIT_CONFIG in the environment to override the location of
the config file.

Alternatively you can use environment variables to select a per-project
file to include with the "include" directive via macro expansion.  This
is documented in cgitrc(5) (search for "include=").

More information about the CGit mailing list