USER'S QUICK REFERENCE
----------------------

*************************************************
*IMPORTANT: THIS SERVER DOES NOT SUPPORT GIT-LFS*
*************************************************

*********************************************
*YOU MAY ACCESS THIS SERVER VIA SSH OR HTTPS*
*********************************************

CLONE A REPO (onto the user local PC)
-------------------------------------

	git clone git@git.barcelli.net:myrepo		#You will need ssh authentication to clone and push.

	git clone https://git.barcelli.net/git/myrepo	#You won't need authentication to clone with https,
							#but you will need it to push to the repo.


ADD A REPO AS REMOTE (to a local repo on the user PC)
-----------------------------------------------------

	git remote add origin git@git.barcelli.net:myrepo.git		#If you want to use ssh.

	git repote add origin https://git.barcelli.net/git/myrepo.git	#if you want to use https.



ADMINISTRATOR'S QUICK REFERENCE
-------------------------------

PROVIDE ACCESS (Users will have access to all repositories in the server)
-------------------------------------------------------------------------

	1. Add the user's ssh public key to server		#for ssh access

	2. sudo htpasswd -m /etc/apache2/git.passwd user1	#for https access

	3. No need to add any credentials for read-only access via https


CREATE A NEW REPOSITORY (on the server by the administrator)
------------------------------------------------------------

	Run the following commands:

		cd /home/git
		sudo mkdir myrepo.git
		sudo chown -R git:www-data myrepo.git
		sudo chmod g+s myrepo.git
		cd myrepo.git
		sudo git init --bare
		cd ..
		sudo chown -R git:www-data myrepo.git
		sudo chmod -R 775 myrepo.git

	Alternative you may run the following script as sudo:

		sudo ./crea_repo.sh myrepo


REFERENCES
----------

	https://git-scm.com/			#git official documentation
	https://learn.smt-acc.com/		#free introductory course to Git with certification