Installing cgit + nginx on Debian Jessie
cgit is a hyperfast web frontend for git repositories written in C. Coupled with nginx, this makes a super quick git repository viewer for your web server. I was not able to find a good tutorial on how to get this installed with nginx on a Debian server. The latest version of Debian Stable (Jessie) comes with cgit already in the repositories so a lot of previous tutorials that had you compile cgit are no longer necessary unless you really need the latest and greatest version of cgit.
Install some software
In order to run cgit with nginx, you will need to install cgit, nginx, and fcgiwrap.
sudo apt-get update sudo apt-get install cgit nginx fcgiwrap
Configure your nginx.conf to work with cgit
The contents of /etc/nginx/nginx.conf
file should look something like this:
worker_processes 1; events { worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; keepalive_timeout 65; gzip on; server { listen 80; server_name git.example.com; # update to be your own domain root /usr/share/cgit; try_files $uri @cgit; location @cgit { include fastcgi_params; fastcgi_param SCRIPT_FILENAME /usr/lib/cgit/cgit.cgi; fastcgi_param PATH_INFO $uri; fastcgi_param QUERY_STRING $args; fastcgi_param HTTP_HOST $server_name; fastcgi_pass unix:/run/fcgiwrap.socket; } } }
Configure cgit Edit /etc/cgitrc
Your file should look like this:
#cgit config #=========== #see cgitrc(5) for details #========================= css=/cgit.css logo=/cgit.png virtual-root=/
Fire it up!
Now you are ready to see cgit. Restart nginx and navigate to your web server.
/etc/init.d/nginx restart
You should see the cgit home screen at your domain name or IP address now.
Add some repos
You can add repos to your /etc/cgitrc
file and they will show up in
cgit. The repo section of this file should look something like this:
# List of repositories. # This list could be kept in a different file (e.g. '/etc/cgitrepos') # and included like this: # include=/etc/cgitrepos repo.url=MyRepo repo.path=/srv/git/MyRepo.git repo.desc=This is my git repository repo.url=MyOtherRepo repo.path=/srv/git/MyOtherRepo.git repo.desc=That's my other git repository
Since cgit is packaged in Debian now, getting up and running is easier than ever. If you ran into any issues following this guide let me know in the comments.
Credits: I got a lot of inspiration from this guide via the awesome Arch Wiki. There were some minor changes that had to be made due to some configuration differences between Arch and Debian.
Thank you for reading! Share your thoughts with me on mastodon or via email.
Check out some more stuff to read down below.
Most popular posts this month
- 3 Years
- Moving to New Jersey
- SQLite DB Migrations with PRAGMA user_version
- Setting up ANTLR4 on Windows
- My Custom Miniflux CSS Theme
Recent Favorite Blog Posts
This is a collection of the last 8 posts that I bookmarked.
- The Framework 13 has a new high-res screen! from David Heinemeier Hansson
- 40 Thoughts At 40 from Blog – Brad Frost
- To Blog or to Social-Post from jwz
- Gotchas with SQLite in Production from Anže’s Blog
- Petter Reinholdtsen: More than 200 orphaned Debian packages moved to git, 216 to go from Planet Debian
- Eli Bendersky: You don't need virtualenv in Go from Planet Python
- Introducing Writebook from Jason Fried
- Reasons to use your shell's job control from Julia Evans
Articles from blogs I follow around the net
SEC charges Galois Capital, Galois settles
Eighteen months after the crypto-focused algorithmic trading fund Galois Capital shut down, explaining that they had lost around $40 million in the FTX collapse, the SEC has filed a lawsuit against the firm for failing to properly cu…
via Web3 is Going Just Great September 3, 2024MagSafe Miscellania
Turns out MagSafe is pretty cool
via Robb Knight • Posts • Atom Feed September 3, 2024Progress
As I'm getting older a lot of my social circles are becoming ever more conservative. The focus shifts from building with ambition to fiercly protecting what one has achieved. Shifting the mind on protectionism makes one consider all that can cause dama…
via Armin Ronacher's Thoughts and Writings September 3, 2024Generated by openring