![[GitPrep logo]](/yuki-kimoto/gitprep/blob/master/gitprep-logo.svg){kind=logo}
GitPrep is a portable Github system, which can be installed and hosted on your own Unix/Linux server.
There is a demo setup at GitPrep example. You will find that GitPrep is a really portable GitHub system and has many features such as repository, pull request, issue and wiki.
- Github clone: GitPrep has the same interface as GitHub.
- Support issue system
- Portable: You can install GitPrep on your own Unix/Linux server.
- Only needs Perl 5.10.1+.
- Smart HTTP support: you can pull and push repository via HTTP.
- Built-in web server, and reverse proxy support.
- CGI support.
- SSL support.
- Public key authentication support
Installation is very easy, requiring only two commands. There are many other configuration settings that can be found in gitprep.conf.
Since the git repositories directory are accessible on the server, it becomes easy to fix mistakes like "git push -f origin master".
All repositories are safely stored only on your server.
This project is open sourced, all free.
Let's try GitPrep. If you like GitPrep, please share and talk about GitPrep in your community or your company.
GitPrep has its own web server. You can start GitPrep easily.
Create a gitprep user. This is not necessary, but recommended:
useradd gitprep
su - gitprep
cd ~
git --version
Check Perl version. You can use GitPrep if the Perl version is 5.10.1+;
perl -v
If you don't have Perl 5.10.1+, you need to install a newer perl version with perlbrew.
curl -L http://install.perlbrew.pl | bash
echo "source ~/perl5/perlbrew/etc/bashrc" >> ~/.bash_profile
source ~/.bash_profile
perlbrew install perl-5.16.3
perlbrew switch perl-5.16.3
perl -v
# Pulls a shallow copy from this repository
git clone --depth=1 https://github.com/yuki-kimoto/gitprep
cd gitprep
# This will install the necessary modules, create the config file and data folder
./setup
# To update in future, run
./updateDownload from the repository and change directory:
git clone --depth=1 https://github.com/yuki-kimoto/gitprep
cd gitprep
Setup. Needed modules are installed.
./setup_module
If this fails and extlib directory already exists, try to remove "extlib" and run "./setup_module" again.
rm -rf extlib
./setup_module
Check if module setup successes. Run the following command.
prove t
If "syntax OK" is displayed, setup was successful.
Setup database.
./setup_database
If you used GitPrep version 1 and upgrade it to version 2, you need to upgrade database with the following command
# Backup gitprep directory for safety
cd ..
cp -rp gitprep gitprep.bak
# Upgrade database
cd gitprep
mv data/gitprep.db data/gitprep_v1bak.db
./setup_database
old/copy_database_v1_to_v2 data/gitprep_v1bak.db data/gitprep.db
If you install git in your local directory, you have to add the correct git command path to the gitprep.conf config file.
[basic]
;;; Git command path
git_bin=/home/yourname/local/bin/git
And do some settings
git config --global core.quotepath false
You can start the application by running the provided gitprep script. The application is run in the background and the port is 10020 by default.
./gitprep
(If you run this command again, gitprep server restarts.)
Then access the following URL.
http://localhost:10020
If you want to change the port, edit gitprep.conf. If you cannot access this port, you might change the firewall settings.
You can stop the application by adding the --stop option.
./gitprep --stop
You can run GitPrep as CGI script as the following site.
This is shared server. I assume you can connect the server via SSH and login with your own user.
Installation process is same as above except for create user.
If you finish installation, you can access the following URL.
http://yourhost/somepath/gitprep/gitprep.cgi
If you see an internal server error, look at the log file (gitprep/log/production.log) to see what problem has occurred.
After CentOS 6, some perl core modules are not installed by default. You can install Perl core modules by the following command.
yum -y install perl-core
If you install git into your local directory, you must add the correct git command path to the config file gitprep.conf .
[basic]
;;; Git command path
git_bin=/home/yourname/local/bin/git
In GitPrep, blame page uses "git blame --line-porcelain". In old git, there is no --line-porcelain option. We don't know when --line-porcelain was added to git. At least, blame page work well in git 1.8.2.1.
It is very easy. you only overwrite all files except for "gitprep.conf".
If you want to upgrade by "git pull", you can do it. you create "gitprep.my.conf" copied from "gitprep.conf", and do "git pull"
If you get a drinking elephant error after upgrading, you might be missing a new CPAN dependency. Run again "setup.sh".
There are some reasons.
1. Git version is old
If you see "error: RPC failed; result=56, HTTP code = 200" , your git maybe old. Please upgrade to latest git. I checked git version 1.8.5.5.
2. GitPrep restriction
GitPrep restrict max post message size 10MB (This is default of Mojolicious)
You maybe see the following error
Delta compression using up to 4 threads.
Compressing objects: 100% (17830/17830), done.
Writing objects: 100% (18281/18281), 687.05 MiB | 129.92 MiB/s, done.
Total 18281 (delta 295), reused 18281 (delta 295)
error: RPC failed; result=22, HTTP code = 413
fatal: The remote end hung up unexpectedly
fatal: The remote end hung up unexpectedly
Please increase increase the value of MOJO_MAX_MESSAGE_SIZE
# 1GB
export MOJO_MAX_MESSAGE_SIZE=1024000000
3. git restriction
git restrict post max size via http protocol. http.postBuffer value of git config is maybe small.
You maybe see the following error message.
error: RPC failed; result=56, HTTP code = 200
fatal: The remote end hung up unexpectedly
Counting objects: 18281, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (17830/17830), done.
Writing objects: 100% (18281/18281), 687.05 MiB | 133.23 MiB/s, done.
Total 18281 (delta 295), reused 18281 (delta 295)
fatal: The remote end hung up unexpectedly
Everything up-to-date
Please increase the value of http.postBuffer.
# 1GB
git config http.postBuffer 1024000000
You can use GitPrep via reverse proxy access
---------------------------- ------------
---->| Web Server(Reverse proxy)|---->|GitPrep |
<----| (Apache, etc) |<----| |
---------------------------- ------------
I show apache config example. You can use Name virtual host.
# HTTP
<VirtualHost *:80>
ServerName myhost.com
<Proxy *>
Order deny,allow
Allow from all
</Proxy>
ProxyRequests Off
ProxyPreserveHost On
ProxyPass / http://localhost:10020/ keepalive=On
ProxyPassReverse / http://localhost:10020/
RequestHeader set X-Forwarded-Proto "http"
</VirtualHost>
If you use GitPrep via https, you should set X-Forwarded-HTTPS Request Header.
# HTTPS
<VirtualHost *:443>
ServerName myhost.com
<Proxy *>
Order deny,allow
Allow from all
</Proxy>
ProxyRequests Off
ProxyPreserveHost On
ProxyPass / http://localhost:10020/ keepalive=On
ProxyPassReverse / http://localhost:10020/
RequestHeader set X-Forwarded-Proto "https"
</VirtualHost>
GitPrep supports reverse proxy with sub directory.
Here is the apache configuration example:
<VirtualHost *:80>
ServerName perlcodesample.com
ProxyRequests Off
RedirectMatch ^/gitprep$ /gitprep/
<Location /gitprep/>
Require all granted
ProxyPass http://localhost:10020/ keepalive=On
RequestHeader setifempty X-Forwarded-Proto "https" \
expr=%{REQUEST_SCHEME}=='https'
RequestHeader setifempty X-Forwarded-Proto "http" \
expr=%{REQUEST_SCHEME}!='https'
RequestHeader setifempty X-Request-Base "/gitprep/"
ProxyPreserveHost On
</Location>
</VirtualHost>
You can import already existing repositories by script/import_rep script.
cd script
./import_rep -u kimoto rep_dir
-u is user name. rep_dir must contains git repositories like the following.
rep_dir/project1.git
/project2.git
/project3.git
/project3.git
If description file exists in git repository, it is copied.
This is a GitPrep bug before version 1.5.1. Please use after version 1.5.2.
If you continue to use GitPrep before version 1.5.1, collaboration table is broken. Please fix it the following way.
# Run SQLite client
sqlite3 data/gitprep.db
# drop collaboration table
drop table collaboration;
# Restart
./gitprep
GitPrep is timezone-agnostic. It delegates time zone handling to the browser. If you want to change the time zone, do it on your client system.
1. Use symbolic link and ssh_rep_url_base option
At first, set [basic]ssh_rep_url_base option to /~/git
;;; SSH repository url base
; For exampke, If you set this value to /~/git, SSH repository url become
; ssh://gitprep@59.106.185.196/~/git/kimoto/gitprep.git
; ~ is exapned to user home directory automatically
ssh_rep_url_base=/~/git
Next, you create symbolic link to /home/gitprep/gitprep/data/rep
cd ~
ln -s ~/gitprep/data/rep ~/git
2. Use only public key authentication and set [basic]ssh_rep_url_base to empty
If you use only public key authentication, you can access ssh repository using the following url.
ssh://kimoto@59.106.185.196/kimoto/gitprep.git
If you set [basic]ssh_rep_url_base to empty string, this URL is shown on Browser.
;;; SSH repository url base
; For exampke, If you set this value to /git, SSH repository url become
; ssh://kimoto@59.106.185.196/git/kimoto/gitprep.git
ssh_rep_url_base=
You can get atom feed of commits page by the following URL
http://somehost.com/kimoto/gitprep/commits/master.atom
You can manage the application from the root user.
Start the application
sudo -u gitprep /home/gitprep/gitprep/gitprep
Stop the application
sudo -u gitprep /home/gitprep/gitprep/gitprep --stop
If you want to start the application when the OS starts, add the start application command to rc.local(Linux).
If you want to make it easy to manage gitprep, then create a run script.
mkdir -p /webapp
echo '#!/bin/sh' > /webapp/gitprep
echo 'su - gitprep -c "/home/gitprep/gitprep/gitprep $*"' >> /webapp/gitprep
chmod 755 /webapp/gitprep
You can start and stop the application with the following command.
# Start or Restart
/webapp/gitprep
# Stop
/webapp/gitprep --stop
GitPrep 2.0 dropped support for Perl 5.8.7 because latest Mojolicious doesn't support Perl 5.8.
You can choose between those options:
1. use GitPrep 1.xx
GitPrep 1.xx support Perl 5.8.7+. You can use GitPrep v1.12.
https://github.com/yuki-kimoto/gitprep/archive/v1.12.tar.gz
You can see version 1.12 document.
2. You can install your local perl by perlbrew.
perlbrew is a very useful perl installation tool without breaking your system perl.
If you install perl 5.10.1+ with perlbrew, you can install latest GitPrep.
If you use GitPrep on Perl 5.8 and install newer perl with perlbrew, you must remove extlib directory before running the "./setup_module" command.
rm -rf extlib
You should know the following small changes.
1. X-Forwarded-HTTPS header is deprecated. use X-Forwarded-Proto header.
# This is deprecated in GitPrep 2.0
RequestHeader set X-Forwarded-HTTPS "1"
# Use X-Forwarded-Proto instead
RequestHeader set X-Forwarded-Proto "https"
2. remove [basic]show_ignore_space_change_link option
remove [basic]show_ignore_space_change_link option. and move this feature to project settings page.
# Go to settings page in your project
/kimoto/gitprep/settings
3. remove [basic]show_ignore_space_change_link option
remove [basic]show_ignore_space_change_link option. but enable this feature on in project settings page.
# Go to settings page in your project
/kimoto/gitprep/settings
4. remove [basic]encoding_suspects option
remove [basic]encoding_suspects option and move this feature to project settings page.
# Go to settings page in your project
/kimoto/gitprep/settings
**5. mail is required for user registration.
mail address is require for user registration.
Sorry, I found critical database specification mistake in GitPrep from v2.0 to v2.2, and fix it in v2.3. All your pull requests is removed when upgrading from v2.0-v2.2 to v2.3+. Please create Pull request again by the following command.
old/fix_v2_pull_request data/gitprep.db
Sparrowdo
You can use Sparrowdo to install GitPrep on remote server ( by ssh ) or on running Docker container:
Here is example for Docker minimal Debian image:
$ zef install Sparrowdo
$ docker pull bitnami/minideb-extras
$ docker run --name instance0 -d bitnami/minideb-extras -expose=10020:10020 bash
$ sparrowdo \
--bootstrap
--docker=instance1 \
--no_sudo --sparrowfile=deploy/sparrowfile.install.pl6 \
--format=production
$ firefox 127.0.0.1:10020
And for remote server:
$ sparrowdo \
--bootstrap
--host=$ipaddress \
--no_sudo --sparrowfile=deploy/sparrowfile.install.pl6 \
--format=production
$ firefox $ipaddress:10020
Caveat - this installation method is only supported for Linux OS.
Follow Sparrowdo for the details.
Dockerfile and docker-compose
You can use Docker to build your own container based on Alpine Linux. This image configures SSHD to be run by user root and GitPrep to be run by user gitprep.
docker build ./deploy -t yuki-kimoto/gitprep:latest
With that build, you can start a service with docker-compose:
version: "3"
services:
gitprep:
image: yuki-kimoto/gitprep:latest
container_name: gitprep
hostname: gitprep
restart: always
ports:
- "10020:10020"
- "0.0.0.0:2222:22"
volumes:
- gitprep:/home/gitprep
- sshd:/etc/ssh
volumes:
gitprep:
sshd:
If you are a developer, you can start the application in development mode.
./morbo
Then access the following URL.
http://localhost:3000
If you have git, it is easy to install from git.
git clone git://github.com/yuki-kimoto/gitprep.git
It is useful to write configuration in gitprep.my.conf, not gitprep.conf.
GitPrep is the best example for developers who want to create installabel Mojolicious application.
Even if shared hosting server, you can install Mojolicious application as CGI.
###1. cpanm and cpanfile, module installation and version control###
Tatsuhiko Miyagawa's cpanm and cpanfile is the tool which install CPAN module easily.
cpanm is a command. It is one file. you can download cpanm easily and put it in your directory.
cpanfile is a definition of module name and version. you create the following file which name is "cpanfile".
requires 'Time::HiRes', '== 1.9732';
requires 'DBD::SQLite', '== 1.50';
requires 'DBI', '== 1.634';
requires 'DBIx::Connector', '== 0.53';
requires 'Object::Simple', '== 3.14';
requires 'DBIx::Custom', '== 0.36';
requires 'Validator::Custom', '== 1.01';
requires 'Config::Tiny', '== 2.23';
requires 'Mojolicious', '== 6.57';
requires 'Mojolicious::Plugin::BasicAuth', '== 0.08';
requires 'Mojolicious::Plugin::AutoRoute', '== 0.19';
requires 'Mojolicious::Plugin::INIConfig', '== 0.03';
requires 'Mojolicious::Plugin::DBViewer', '== 0.28';
requires 'Mojolicious::Plugin::RequestBase', '== 0.3';
requires 'Text::Markdown::Hoedown', '== 1.01';
requires 'Time::Moment', '== 0.38';
requires 'MIME::Entity', '== 5.510';
requires 'HTML::FormatText::WithLinks', '== 0.15';
requires 'Email::Sender', '== 2.600';
requires 'HTML::Restrict', '== 3.0.0';
requires 'Imager', '== 1.025';
If you want to install all defined modules, you only run the following command.
perl -Iextlib/lib/perl5 cpanm -L extlib --installdeps .
It's ok. but in some environment Module::CoreList is not installed, and latest ExtUtils::MakeMaker is needed for module installation.
I write the following way in "setup_module"
perl cpanm -n -l extlib Module::CoreList
perl -Iextlib/lib/perl5 cpanm -f -L extlib ExtUtils::MakeMaker
perl -Iextlib/lib/perl5 cpanm -L extlib --installdeps .
###2. CGI is supported in Mojolicious
It is good luck for us that Mojolicious author Sebastian Riedel decided to support CGI in Mojolicious.
We can create web application which support CGI with a little effort.
All you do is always using url_for method or url_with method in your templates when you write URL.
<a href="<%= url_for('/foo') %>">Bar</a>
<a href="<%= url_with('/foo') %>">Bar</a>
Mojolicious automatically resolve URL for both embded server and CGI.
After that, you only prepare CGI script to call Mojolicious application in production mode.
#!/usr/bin/env perl
use FindBin;
use lib "$FindBin::Bin/extlib/lib/perl5";
$ENV{MOJO_MODE} = 'production';
require "$FindBin::Bin/script/gitprep";
GitPrep depends on the following modules, especially Mojolicious is the base of GitPrep. Thanks to Mojolicious author, Sebastian riedel.
- Mojolicious
- Mojolicious::Plugin::INIConfig
- Mojolicious::Plugin::AutoRoute
- Mojolicious::Plugin::BasicAuth
- Mojolicious::Plugin::DBViewer
- Mojolicious::Plugin::RequestBase
- Object::Simple
- Text::Markdown::Hoedown
- Validator::Custom
- Time::Moment
- Config::Tiny
- DBD::SQLite
- DBI
- DBIx::Connector
- DBIx::Custom
- HTML::FormatText::WithLinks
- MIME::Entity
- Email::Sender
- HTML::Restrict
- Imager
These are my Perl web application projects.
- WebDBViewer - Database viewer to see database information on web browser.
If you find some bug, please report it as a GitHub issue. Small bugs are OK! I'm pleased if you report anything buggy.
Yuki Kimoto
If you are interested in my projects and activity, Please follow me on X.
Thanks for helping my GitPrep project.
- monnerat
- bilogic
- maspalio
- djzort
- SvenDowideit
- melezhik
- spatil47
- reneeb
- tetsuh
- flixh
- kopytov
- kberov
- deavmi
- jackivan88
- mrmuskrat
- knittl
- programmerMOT
- sn0
- socialmedialabs
- troneill
- brainchild0
- emil-perhinschi
Copyright 2012-2024 Yuki Kimoto. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the terms of either:
a. the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or
b. the "Artistic License" which comes with this Kit.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See either the GNU General Public License or the Artistic License for more details.
You should have received a copy of the Artistic License with this Kit, in the file named "Artistic". It can also be found at https://dev.perl.org/licenses/artistic.html.
You should also have received a copy of the GNU General Public License along with this program in the file named "Copying". If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA or visit their web page on the internet at https://www.gnu.org/copyleft/gpl.html.
Bundled vectorial icons (octicons) are covered by the MIT license.
