Public Access (Read-Only)
Given your-project
with the project name, clone over HTTP from the URL, http://rtsrv.cs.unc.edu/cgit/cgit.cgi/your-project.git/
.
Example:
git clone http://rtsrv.cs.unc.edu/cgit/cgit.cgi/libsmctrl.git/
.
Using this server
Contact the current server admin (jbakita@cs as of 2023) if you need help with something not covered below.
Creating a Repository
Tutorial:
- SSH to rtsrv.cs.unc.edu using your CS login and password
- First choose where to put it! For long running projects,
/home/litmus/
is the recommended location, but you can also use your home directory if it is a temporary repository. - Now choose a project name! Then create a directory in your desired storage location named
your-project-name.git
. - Change into your new directory and initialize it as a git repository with the command
git init --bare
. - You can now clone your repository with
git clone your_cs_username@rtsrv.unc.edu:/full/path/to/your-project.git
- but we can make this easier. - To shorten the clone command and enable the web interface, link your repository to
/public/
withln -s /path/to/your-project.git /public/
. - As soon as the cgit cache updates (may take several minutes), you can now see your project listed in the web interface!
- You may notice that your project has no description shown online in cgit. To fix this, add a one-line description to
/public/your-project.git/description
. - Done!
Quick reference:
ssh rtsrv.cs.unc.edu
mkdir /home/litmus/your-project.git
cd /home/litmus/your-project.git
git init --bare
ln -s "$(pwd)" /public/
vim description
Clone Read/Write (CS Account Required)
git clone your_cs_username@rtsrv.cs.unc.edu:/public/your-project.git
Replace rtsrv.cs.unc.edu
with rtsrv-eth.telenet.unc.edu
for off-campus access via SSH.
Migrate from GitHub
If you are migrating a repository in the default configuration from GitHub:
git remote set-url origin your_cs_username@rtsrv.cs.unc.edu:/public/your-project.git
git push --all origin
Maintaining this File
This file is /home/litmus/README.md on rtsrv.cs.unc.edu, rendered to HTML by cgit.