Gitlist 1.x (Legacy) Setup     2026/07/27
Ami Sapphire

---

1. Apache 2.4.x - .conf file

1.1. Your httpd.conf file needs rewrite module compiled, installed, and enabled.

1.2. Your httpd.conf (or custom .conf file) needs the following:

Alias /gitlist /path/to/gitlist/
<Directory /path/to/gitlist>
    Options +FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>


2. gitlist - .htaccess

An example .htaccess file:

<IfModule mod_rewrite.c>
    Options -MultiViews +SymLinksIfOwnerMatch

    RewriteEngine On
    #RewriteBase /path/to/gitlist

    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ index.php/$1 [L,NC]
</IfModule>
<Files config.ini>
    order allow,deny
    deny from all
</Files>

There is normally a RewriteBase in there, but it tends to break things in
general, so it commented out here.


3. gitlist - config.ini

Mainly, only respositories[] is changed to your repository directory.


4. If you have dubious ownership of your repositories, usually:

git config --global --edit

would work, but that is tied to each user.


A sledgehammer version is actually:

git config --system --edit


From there, you would have:

[safe]
    Directory = /path/to/specific/git/repository

then save.