/README (396618e3cd6577a51a514e7f1692cb92a47bfbfb) (3442 bytes) (mode 100644) (type blob)
== About ==
. Website: http://kernel.embedromix.ro/us/
. Author: Catalin(ux) M. BOIE
. Description: Light and fast Git hosting solution
. License: GPLv3
. Language: PHP (plans to rewrite in C after official release)
. Database: PostgreSQL
== Features ==
. Free software
. No Java
. No Javascript
. Upgrades with the standard tools of the distributions
. Very little dependencies, all packaged in main-stream distributions
. SELinux friendly
. Very small
== Install ==
. Notes:
- It is recommended to NOT install rocketgit on a multiuser machine.
There are some things that should be fixed first. We are working on it.
. Prepare SELinux
# setsebool -P \
httpd_can_network_connect_db=on \
httpd_can_sendmail=on
. Edit /etc/rocketgit/config.php
. Edit /etc/httpd/conf.d/rocketgit.conf
. PHP
Adjust php.ini to:
- allow enough RAM and execution time
- fix timezone
. Activate web server
# systemctl enable httpd.service
# systemctl restart httpd.service
. Activate sshd (for ssh:// access)
# systemctl enable sshd.service
# systemctl start sshd.service
. Activate xinetd (for git:// access)
# systemctl enable xinetd.service
# systemctl start xinetd.service
. Configure PostgreSQL server
# systemctl enable postgresql.service
# postgresql-setup initdb (TAKE CARE! YOU MAY DESTROY ALL YOUR DATA!)
# systemctl start postgresql.service
. Create a PostgreSQL user and database
# su - postgres
$ createuser -d -R -S rocketgit
$ createdb -O rocketgit rocketgit
. Allow access to PostgreSQL and restart:
Add the following lines, before wildcard matches, in
/var/lib/pgsql/data/pg_hba.conf:
local rocketgit rocketgit trust
host rocketgit rocketgit 127.0.0.1/32 trust
host rocketgit rocketgit ::1/128 trust
systemctl restart postgresql.service
Notes:
- Check also the config file (/etc/rocketgit/config.php) and set
correctly the rg_sql string.
- If the web server and the db are not on the same host, you need to
replace 127.0.0.1/::1 with your "safe network". You may want to use
md5 for authentication. Also, you may want to change 'listen_addresses'
to '*'. You may also want to activate SSL. Check PostgreSQL manual.
. Mail
To be able to generate e-mails as other user, you have to:
For sendmail:
- Enable daemon: systemctl enable sendmail.service
- Edit /etc/mail/trusted-users and add 'rocketgit' and 'apache'.
- Restart daemon: 'systemctl restart sendmail.service' (Fedora)
. Run instalation script
# php /usr/share/rocketgit/admin/init.php
. Edit firewall to permit ssh, git, http and https ports
In /etc/sysconfig/iptables (IPv4) and ip6tables (IPv6), add something
like this:
-A INPUT -m tcp -p tcp --dport ssh -j ACCEPT
-A INPUT -m tcp -p tcp --dport git -j ACCEPT
-A INPUT -m tcp -p tcp --dport http -j ACCEPT
-A INPUT -m tcp -p tcp --dport https -j ACCEPT
== Thanks ==
. Special thanks to my family that supported me in this project.
. Special thanks to my brother that contributed brain and time to this project.
. Special thanks to git people for the best tool to manage the sources.
. Special thanks to Petre Bandac for free hosting of rg2 server.
. Special thanks to a lot of people that came with suggestions.
. Special thanks to gitosys, Gitorious and other projects from where I learned
things.
. Special thanks to OWASP for their good documentation on how to write a
web application.
. See AUTHORS file for all the people who contributed to this project.
Mode |
Type |
Size |
Ref |
File |
100644 |
blob |
9 |
f3c7a7c5da68804a1bdf391127ba34aed33c3cca |
.exclude |
100644 |
blob |
96 |
5ca30a3adc6cef38f30cbc1e111154c2b5154229 |
.gitignore |
100644 |
blob |
179 |
df01c6306393e7a8b180470b4beb8831e6c421e0 |
AUTHORS |
100644 |
blob |
1131 |
c4293c8abbcc8446af598c33486e1ec4561388d4 |
Certs.txt |
100644 |
blob |
682 |
829015f1d88a8fc2e6da1e6ce4c79a7c3abeef8c |
Compare.txt |
100644 |
blob |
201 |
8dd879f847aaf2e4e63752cd05037ae879a9c17b |
History.txt |
100644 |
blob |
35147 |
94a9ed024d3859793618152ea559a168bbcbb5e2 |
LICENSE |
100644 |
blob |
2150 |
56d42993364a23fbbfb3caac649cb2883d9259af |
Makefile.in |
100644 |
blob |
3442 |
396618e3cd6577a51a514e7f1692cb92a47bfbfb |
README |
100644 |
blob |
51193 |
187ac6d8195538f7ec28dde0ff8bcdf57527d4a6 |
TODO |
100644 |
blob |
1294 |
f22911eb777f0695fcf81ad686eac133eb11fcc4 |
TODO-plans |
040000 |
tree |
- |
f2f566edc152d9ce1548c18d6b81e3bc32a47714 |
admin |
040000 |
tree |
- |
76a16691bc48bbe42bdc63a6d1244d2d49e4da2d |
artwork |
100755 |
blob |
30 |
92c4bc48245c00408cd7e1fd89bc1a03058f4ce4 |
configure |
040000 |
tree |
- |
f67d3605efbd6422a8acdd953578991139266391 |
docs |
100755 |
blob |
13704 |
87c4881d7f32f8179d29d86ee17ddbe0f6254c57 |
duilder |
100644 |
blob |
291 |
27c90d64c197fb0a4451b6398a24bbcacbee02ab |
duilder.conf |
040000 |
tree |
- |
d7ba62d78c4c4aa191a64ab04e9a28ce2685a893 |
hooks |
040000 |
tree |
- |
3f671b7b3ff4210aac0f514c9f72bde522e11f2b |
inc |
100644 |
blob |
3460 |
05bc4d22e0db225b7c30b1b44ec4065add612b8b |
rocketgit.spec.in |
040000 |
tree |
- |
e2e11018b32f119c65f70785640af092d83b4009 |
root |
040000 |
tree |
- |
6e1b4b4a33bec35c47d6465b6fb0332fbf03701e |
samples |
040000 |
tree |
- |
faf5f7d7bed959c0f40153e50de2ed3da70d541f |
scripts |
040000 |
tree |
- |
d01f9931180da51ccf73748fad68839c17d3c15a |
selinux |
040000 |
tree |
- |
efb32e32cfa5a2ab9dc2fdafa43ff1e672979d38 |
tests |
Hints:
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"
Clone this repository using HTTP(S):
git clone https://rocketgit.com/user/catalinux/rocketgit
Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@ssh.rocketgit.com/user/catalinux/rocketgit
Clone this repository using git:
git clone git://git.rocketgit.com/user/catalinux/rocketgit
You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a
merge request:
... clone the repository ...
... make some changes and some commits ...
git push origin main