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.

20e2cad8

**Note about versioning:** Versions are cut in Major.Minor.Patch schema. Major is always the current year. Minor is either 4 (January - June) or 10 (July - December). Patch is incremental by every build. If there is a breaking change, it should be noted in the readme.

486b0f2a

dee19b20

---

dd6b4dea

4b15a9e1

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

dd6b4dea

20e2cad8

[![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)

f1e4d5b9

20e2cad8

## P3X Sponsor

ee2f9a4b

5a07fb6b

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

5e6d4971

20e2cad8

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

f1e4d5b9

dd6b4dea

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