P3X GitList

dd6b4dea

[//]: #@corifeus-header

eaf66dc1

# 🤖 P3X Gitlist - A decorated enhanced elegant, feature rich and modern private 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`.

3f64bd76

* Open up the `config.ini` and configure your installation. You'll have to provide where your repositories are located and the base GitList URL.

8d76b720

* 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 ---

ea3be972

🙏 This is an open-source project. Star this repository, if you like it, or even donate to maintain the servers and the development. Thank you so much! Possible, this server, rarely, is down, please, hang on for 15-30 minutes and the server will be back up. All my domains ([patrikx3.com](https://patrikx3.com) and [corifeus.com](https://corifeus.com)) could have minor errors, since I am developing in my free time. However, it is usually stable.

dee19b20

--- [**P3X-GITLIST**](https://pages.corifeus.com/gitlist) Build v2019.10.107

dd6b4dea

a2094c1d

[![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) [![Like Corifeus @ Facebook](https://img.shields.io/badge/LIKE-Corifeus-3b5998.svg)](https://www.facebook.com/corifeus.software)

dd6b4dea

f1e4d5b9

ccaa04c8

## P3X Sponsors

ee2f9a4b

5a07fb6b

[IntelliJ - The most intelligent Java IDE](https://www.jetbrains.com/?from=patrikx3)

5e6d4971

5a07fb6b

[![JetBrains](https://cdn.corifeus.com/assets/svg/jetbrains-logo.svg)](https://www.jetbrains.com/?from=patrikx3) [![NoSQLBooster](https://cdn.corifeus.com/assets/png/nosqlbooster-70x70.png)](https://www.nosqlbooster.com/)

5e6d4971

[The Smartest IDE for MongoDB](https://www.nosqlbooster.com)

ee2f9a4b

dd6b4dea

f1e4d5b9

dd6b4dea

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