Using cgit
This is the last post in a three part series about cgit. Previously we saw how to install and configure cgit and then we saw how to make cgit pretty. This last post has to do with actually using cgit. There are a couple of tools out there to make the process of adding, removing, and modifying git repositories within cgit much simpler but we will focus here on how to do it manually and I will leave it up to you to decide which tools works best for you. cgit does not impose any special requirements for adding, removing, or modifying repositories so the entire process is based around core git functionality. Below is a workflow that works well for me.
Creating a Git User
Creating a git user that has access to/srv/git
just makes good sense. To add a new user in Debian you will need to run the following commands and follow the on screen instructions to complete this process. adduser git
Adding your public key
In order to authenticate to the server and work with git it is good to add your public key to avoid working with passwords. If you do not already have a key, go ahead and create one on your local machine.ssh-keygen -b 8192
Follow the on screen instructions, and be sure to add a password to this key! Once you have create this key, copy the public key over to your git server under the git users .ssh/authorized_keys
file. scp $USER/.ssh/id_rsa.pub [email protected]:/home/git/.ssh/authorized_keys
Creating a new repository
Log into the git server as the git user and create a bare repositorycd /srv/git mkdir myrepo.git cd myrepo.git git init --bare
Push to the new repository
On your local computermkdir myrepo cd myrepo git init echo "My Awesome Repo" >> README.md git add README.md git commit -m 'initial commit' git remote add origin [email protected]:/srv/git/myrepo.git git push origin master
Add the new repository to cgit
Now that your repository is on your server, you can add it cgit by editing/etc/cgitrc
and adding it as we did before.
repo.url = myrepo repo.path = /srv/git/myrepo.git repo.desc = My Awesome Repo repo.owner = Your Name
Thank you for reading! Share your thoughts with me on bluesky, mastodon, or via email.
Check out some more stuff to read down below.
Most popular posts this month
- 2024
- Reinstalling Windows at 1am
- SQLite DB Migrations with PRAGMA user_version
- My Custom Miniflux CSS Theme
- How to Disable Wayland in Debian Testing
Recent Favorite Blog Posts
This is a collection of the last 8 posts that I bookmarked.
- Give Your Spouse the Gift of a Couple's Email Domain from mtlynch.io
- Have smart glasses finally hit an inflection point? from The Torment Nexus
- The McPhee method from the jsomers.net blog
- Pluralistic: LLMs are slot-machines (16 Aug 2025) from Pluralistic: Daily links from Cory Doctorow
- Pluralistic: Bluesky creates the world's weirdest, hardest-to-understand binding arbitration clause (15 Aug 2025) from Pluralistic: Daily links from Cory Doctorow
- Just a Little More Context Bro, I Promise, and It’ll Fix Everything from Jim Nielsen’s Blog
- The Futzing Fraction from Deciphering Glyph
- Sit On Your Ass Web Development from Jim Nielsen’s Blog
Articles from blogs I follow around the net
Issue 91 – GDP on the blockchain
The regulator set to take on primary crypto oversight is down to a single Commissioner, and new pro-crypto PACs focus on installing more Republicans in the midterms
via Citation Needed August 27, 2025V&A East Storehouse and Operation Mincemeat in London
We were back in London for a few days and yesterday had a day of culture. First up: the brand new V&A East Storehouse museum in the Queen Elizabeth Olympic Park near Stratford, which opened on May 31st this year. This is a delightful new format for a mu…
via Simon Willison's Weblog: Entries August 27, 2025Generated by openring