How to Install Cgit on Debian Latest

Introduction

Cgit is a fast, lightweight and web interface for Git repositories written in C. It allows browsing through Git repositories using a web browser. In this tutorial, we will show you how to install Cgit on Debian Latest.

Prerequisites

Before starting with the installation of Cgit, make sure that:

• You have a Debian Latest operating system running on your machine.
• You have root access to your Debian machine.
• You have installed Git and Nginx web server.

Step 1: Install Dependencies

The first step is to install the necessary dependencies to build and install Cgit. Open the terminal and run the following command:

sudo apt-get update
sudo apt-get install libssl-dev zlib1g-dev gettext cmake

This command will update the package list and install the necessary dependencies.

Step 2: Download Cgit

Next, download the latest stable version of Cgit from the official website using the wget command:

wget https://git.zx2c4.com/cgit/snapshot/cgit-1.2.3.tar.gz

After downloading the Cgit package, extract it using the tar command:

tar -xvzf cgit-1.2.3.tar.gz

Step 3: Build and Install Cgit

To build and install Cgit, we need to navigate to the Cgit source directory and run the following commands:

cd cgit-1.2.3
make
sudo make install

This command will build the Cgit binary and install it in /usr/local/bin.

Step 4: Configure Nginx

The next step is to configure Nginx to serve Cgit web pages. Open the Nginx configuration file using your favorite text editor:

sudo nano /etc/nginx/nginx.conf

Add the following configuration inside the http block:

server {
    listen 80;
    server_name cgit.example.com;

    location / {
        index cgit.cgi;
        fastcgi_pass unix:/var/run/fcgiwrap.socket;
        include /etc/nginx/fastcgi_params;
        fastcgi_param SCRIPT_FILENAME /usr/local/bin/$fastcgi_script_name;
    }
}

This configuration will listen on port 80 with the server name cgit.example.com and serve the cgit.cgi binary using the fcgiwrap socket. If you have a different domain name, change the server name accordingly.

After making the changes, save and close the file.

Step 5: Restart Nginx

Next, restart the Nginx server to apply the changes:

sudo systemctl restart nginx

Step 6: Create a Git Repository

To test Cgit, create a new Git repository:

mkdir /var/git
cd /var/git
git init sample.git
touch sample.git/git-daemon-export-ok

This command will create a new Git repository named 'sample.git' in the /var/git directory.

Step 7: Access Cgit

Open your web browser and navigate to http://cgit.example.com/. You should see the Cgit home page.

To browse the created Git repository, enter the repository URL in the search bar, for example, http://cgit.example.com/sample.git/.

Congratulations, you have successfully installed and configured Cgit on Debian Latest.

Conclusion

Cgit is a fast and lightweight web interface for Git repositories. It allows browsing through Git repositories using a web browser. In this tutorial, we have shown you how to install and configure Cgit on Debian Latest.