P3X GitList

dd6b4dea

[//]: #@corifeus-header

79e42b5c

# 🤖 P3X Gitlist - An elegant, feature rich and modern git ui repository viewer

dd6b4dea

[//]: #@corifeus-header:end

8d76b720

# GitList Installation

f1e4d5b9

* Download GitList from [https://github.com/patrikx3/gitlist/releases](https://github.com/patrikx3/gitlist/releases/) and decompress to your `/var/www/gitlist` folder, or anywhere else you want to place GitList. * Rename the `config.example.ini-example` file to `config.ini`.

8d76b720

* Open up the `config.ini` and configure your installation. You'll have to provide where your repositories are located and the base GitList URL (in our case, http://localhost/gitlist). * Create the cache folder and give read/write permissions to your web server user: ``` cd /var/www/gitlist

dd6b4dea

mkdir -p cache

8d76b720

chmod 777 cache ``` That's it, installation complete! ## Webserver configuration

88d15491

3d1302a5

Apache is the "default" webserver for GitList. You will find the configuration inside the `.htaccess` file. However, nginx and lighttpd are also supported.

8d76b720

8748c6bb

To make it to be more secure: All `PHP` files will be in the `root` and only `index.php`, `images`, `icons`, `svg`, `css`, `js`bundle files will be in the `public` subdir.

8d76b720

### nginx server.conf ``` server { server_name MYSERVER;

087d9506

access_log /var/log/nginx/MYSERVER.access.log combined; error_log /var/log/nginx/MYSERVER.error.log error;

8d76b720

8748c6bb

root /var/www/DIR/public;

8d76b720

index index.php; # auth_basic "Restricted";

087d9506

# auth_basic_user_file .htpasswd;

8d76b720

location = /robots.txt { allow all; log_not_found off; access_log off; } location ~* ^/index.php.*$ {

087d9506

fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

88d15491

# if you're using php7.2-fpm via socket fastcgi_pass unix:/var/run/php7.2-fpm.sock;

087d9506

88d15491

include snippets/fastcgi-php.conf;;

8d76b720

}

88d15491

location ~ \.php$ { include snippets/fastcgi-php.conf; fastcgi_pass $php_listener;

8d76b720

}

88d15491

location ~ /\.ht { deny all; }

8d76b720

location ~* \.(js|css|png|jpg|jpeg|gif|ico)$ { add_header Vary "Accept-Encoding"; expires max; try_files $uri @gitlist; tcp_nodelay off; tcp_nopush on; } # location ~* \.(git|svn|patch|htaccess|log|route|plist|inc|json|pl|po|sh|ini|sample|kdev4)$ { # deny all; # }

88d15491

8d76b720

} ```

8748c6bb

### lighthttpd I do not use `lighthttpd`, but you know what I mean. Make sure only, the `gitlist/public` folder should be enabled.

8d76b720

```

8748c6bb

# GitList is located in /var/www/gitlist/

8d76b720

server.document-root = "/var/www" url.rewrite-once = ( "^/gitlist/web/.+" => "$0", "^/gitlist/favicon\.ico$" => "$0", "^/gitlist(/[^\?]*)(\?.*)?" => "/gitlist/index.php$1$2" )

3d1302a5

``` ### hiawatha

8748c6bb

I do not use `hiawatha`, but you know what I mean. Make sure only, the `gitlist/public` folder should be enabled.

3d1302a5

``` UrlToolkit { ToolkitID = gitlist RequestURI isfile Return # If you have example.com/gitlist/ ; Otherwise remove "/gitlist" below Match ^/gitlist/.* Rewrite /gitlist/index.php Match ^/gitlist/.*\.ini DenyAccess } ```

f1e4d5b9

dd6b4dea

[//]: #@corifeus-footer ---

f8f7b879

[**P3X-GITLIST**](https://pages.corifeus.com/gitlist) Build v2018.11.24-0

dd6b4dea

93e0edb8

[![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software) [![Donate for Corifeus / P3X](https://img.shields.io/badge/Donate-Corifeus-003087.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=QZVM4V6HVZJW6) [![Contact Corifeus / P3X](https://img.shields.io/badge/Contact-P3X-ff9900.svg)](https://www.patrikx3.com/en/front/contact)

dd6b4dea

f1e4d5b9

ccaa04c8

## P3X Sponsors

ee2f9a4b

5e6d4971

[IntelliJ - The most intelligent Java IDE](https://www.jetbrains.com) [![JetBrains](https://cdn.corifeus.com/assets/svg/jetbrains-logo.svg)](https://www.jetbrains.com/) [![NoSQLBooster](https://cdn.corifeus.com/assets/png/nosqlbooster-70x70.png)](https://www.nosqlbooster.com/) [The Smartest IDE for MongoDB](https://www.nosqlbooster.com)

ee2f9a4b

dd6b4dea

f1e4d5b9

dd6b4dea

[//]: #@corifeus-footer:end