== 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)
. 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_network_memcache=on \
		httpd_can_sendmail=on

. Edit /etc/rocketgit/config.php
. Edit /etc/httpd/conf.d/rocketgit.conf

. Activate web server
	# systemctl enable httpd.service
	# systemctl start 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 pg_hba.conf:
	local rocketgit rocketgit 127.0.0.1	trust
	local rocketgit rocketgit ::1		trust

	systemctl reload postgresql.service

	Notes:
	- Check also the config file and set correctly 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:
		- 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) or 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

. PHP
	Adjust php.ini to:
		- allow enough RAM and execution time
		- fix timezone


== 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 a lot of people that came with suggestions.
. Special thanks to gitosys, Gitorious and other projects from where I learned
	things.
. See AUTHORS file for all the people who contributed to this project.