{"id":7665,"date":"2024-06-04T21:31:05","date_gmt":"2024-06-05T04:31:05","guid":{"rendered":"https:\/\/ioflood.com\/blog\/?p=7665"},"modified":"2024-06-04T21:33:16","modified_gmt":"2024-06-05T04:33:16","slug":"install-gitea-linux","status":"publish","type":"post","link":"https:\/\/ioflood.com\/blog\/install-gitea-linux\/","title":{"rendered":"Gitea Setup Guide | Installation Methods for Linux"},"content":{"rendered":"
\n
\"Design<\/figure>\n<\/div>\n

We utilize self-hosted Git repository solutions commonly while developing software for Linux servers at IOFLOOD<\/a>. From our experience, Gitea’s user-friendly Git workflows and collaboration tools makes it an ideal platform for managing code repositories and projects. Todays article has been filled with tips and tricks too empower our customers and fellow developers with the knowledge and steps required to enhance their collaboritive programming experience on dedicated Remote servers<\/a>.<\/p>\n

In this guide, we will navigate you through the process of installing Gitea on your Linux system.<\/strong> We will show you methods for installing with APT distros like Ubuntu and Debian as well as YUM-based distributions like CentOS and AlmaLinux. We’ll also delve into more advanced topics like compiling Gitea from the source, how to install a specific version, and finally, how to use the Gitea command and verify that the correct version is installed.<\/p>\n

Let’s dive in and begin installing Gitea on your Linux system!<\/p>\n

TL;DR: How Do I Install Gitea on Linux?<\/h2>\n

\n To install Gitea on Debian-based systems like Ubuntu, use sudo apt-get install gitea<\/code>. For RPM-based systems like CentOS, use sudo yum install gitea<\/code>. You can then access Gitea via your web browser at http:\/\/localhost:3000<\/code> after starting the Gitea service. You can also download the Gitea binary<\/a> from the official website using the wget<\/code> command.\n<\/p><\/blockquote>\n

Here’s a quick example:<\/p>\n

wget -O gitea https:\/\/dl.gitea.io\/gitea\/1.14.1\/gitea-1.14.1-linux-amd64\nchmod +x gitea\n.\/gitea web\n<\/code><\/pre>\n
This will download the Gitea binary, make it executable, and start the Gitea web service. You should now be able to access Gitea at http:\/\/localhost:3000<\/code> in your web browser.<\/p>\n
While this is a basic way to install Gitea on Linux, there’s much more to learn about installing and using Gitea. Continue reading for more detailed information and advanced installation options.<\/p>\n
Basic Gitea Installation on Linux<\/h2>\n
Gitea is a self-hosted Git service, much like GitHub or GitLab, but significantly lighter and easy to install. It’s a fantastic tool for developers and teams who want to manage their Git repositories on their own server, offering a user-friendly interface and a host of features.<\/p>\n
Now, let’s discuss how to install Gitea on Linux. We will primarily focus on two package management systems, APT and YUM, which are widely used in various Linux distributions.<\/p>\n
Installing Gitea with APT (Debian, Ubuntu)<\/h3>\n
If you’re using a Debian-based distribution like Ubuntu, you can install Gitea using the APT package manager. Here’s how:<\/p>\n
sudo apt-get update\nsudo apt-get install git\nwget -O gitea https:\/\/dl.gitea.io\/gitea\/1.14.1\/gitea-1.14.1-linux-amd64\nchmod +x gitea\n<\/code><\/pre>\n
In this code block, we first update the package lists for upgrades and new package installations (sudo apt-get update<\/code>). Next, we install Git (sudo apt-get install git<\/code>). We then download the latest Gitea binary using the wget<\/code> command and make it executable with chmod +x gitea<\/code>.<\/p>\n
Installing Gitea with YUM (CentOS, RHEL)<\/h3>\n
If you’re using a Red Hat-based distribution like CentOS, you can use the YUM package manager to install Gitea. Here’s the process:<\/p>\n
sudo yum update\nsudo yum install git\nwget -O gitea https:\/\/dl.gitea.io\/gitea\/1.14.1\/gitea-1.14.1-linux-amd64\nchmod +x gitea\n<\/code><\/pre>\n
This code block is very similar to the APT one. We start by updating the system (sudo yum update<\/code>), then install Git (sudo yum install git<\/code>). Finally, we download the Gitea binary and make it executable (chmod +x gitea<\/code>).<\/p>\n
In both methods, you have now installed Gitea on your Linux system. You can start the Gitea service by running .\/gitea web<\/code> in the directory where you downloaded the binary.<\/p>\n
Installing Gitea from Source<\/h2>\n
For those who prefer building from source or need a specific version of Gitea, you can compile Gitea from the source code. This method offers a greater level of control over the installation process and can be beneficial for developers who wish to modify or extend the functionality of Gitea.<\/p>\n
Here’s how you can install Gitea from source:<\/p>\n
sudo apt-get install git golang\nmkdir -p $GOPATH\/src\/code.gitea.io\ncd $GOPATH\/src\/code.gitea.io\ngit clone https:\/\/github.com\/go-gitea\/gitea.git\ncd gitea\nTAGS=\"bindata\" make build\n<\/code><\/pre>\n
This will install the necessary dependencies (git<\/code> and golang<\/code>), clone the Gitea repository, and build the Gitea binary.<\/p>\n
Installing Different Versions of Gitea<\/h2>\n
Installing Specific Version from Source<\/h3>\n
If you need a specific version of Gitea, you can check out the desired version’s tag before building. Here’s how:<\/p>\n
cd $GOPATH\/src\/code.gitea.io\/gitea\ngit checkout v1.14.1\nTAGS=\"bindata\" make build\n<\/code><\/pre>\n
This will build Gitea version 1.14.1 from source.<\/p>\n
Installing Specific Version with Package Managers<\/h3>\n
With APT<\/h4>\n
On Debian-based distributions, you can install a specific version of a package using the =<\/code> operator followed by the version number. However, Gitea’s binary releases are not available in the official Debian or Ubuntu repositories, so you can’t install a specific version with APT. You’ll have to download the specific version from the Gitea website or build it from source.<\/p>\n
With YUM<\/h4>\n
Like APT, YUM doesn’t support installing a specific version of Gitea because it’s not available in the official repositories of Red Hat-based distributions. You’ll need to download the specific version from the Gitea website or build it from source.<\/p>\n
Version Comparison<\/h3>\n
Each version of Gitea includes new features, improvements, and bug fixes. You can find detailed release notes on the Gitea blog<\/a>.<\/p>\n
Here’s a brief comparison of the last three versions:<\/p>\n\n\n\n\n\n\n\n
Version<\/th>\nKey Features<\/th>\nRelease Date<\/th>\n<\/tr>\n<\/thead>\n
1.14.1<\/td>\nImproved issue search, added support for PostgreSQL 13<\/td>\nApril 2021<\/td>\n<\/tr>\n
1.14.0<\/td>\nAdded support for custom avatars, improved OAuth2 support<\/td>\nMarch 2021<\/td>\n<\/tr>\n
1.13.0<\/td>\nAdded support for PostgreSQL 12, improved Docker support<\/td>\nDecember 2020<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Using and Verifying Gitea<\/h2>\n
Basic Usage of Gitea<\/h3>\n
Once you’ve installed Gitea, you can start it with the .\/gitea web<\/code> command. This will start the Gitea web service, and you can access Gitea at http:\/\/localhost:3000<\/code> in your web browser.<\/p>\n
Verifying the Installation<\/h3>\n
You can verify that Gitea is installed correctly and check its version with the .\/gitea --version<\/code> command:<\/p>\n
.\/gitea --version\n<\/code><\/pre>\n
This command should output the version of Gitea that you installed, like this:<\/p>\n
Gitea version 1.14.1 built with GNU Make 4.1, go1.15.6 : bindata, sqlite, sqlite_unlock_notify\n<\/code><\/pre>\n
This confirms that Gitea version 1.14.1 is installed correctly.<\/p>\n
Alternative Git Services<\/h2>\n
While Gitea is a powerful and lightweight self-hosted Git service, it’s not the only option out there. Depending on your needs, you might find GitLab or GitHub to be more suitable. Let’s explore these alternatives and how to set them up on your Linux system.<\/p>\n
GitLab: An All-in-One DevOps Platform<\/h3>\n
GitLab is a comprehensive DevOps platform that integrates a Git repository manager with CI\/CD capabilities, issue tracking, and more. GitLab’s extensive feature set makes it an excellent choice for teams looking for an all-in-one solution.<\/p>\n
To install GitLab on Ubuntu, you can use the Omnibus package, which includes all dependencies and can be configured with a single command:<\/p>\n
sudo apt-get update\nsudo apt-get install -y curl openssh-server ca-certificates tzdata postfix\nsudo curl https:\/\/packages.gitlab.com\/install\/repositories\/gitlab\/gitlab-ce\/script.deb.sh | sudo bash\nsudo apt-get install gitlab-ce\n<\/code><\/pre>\n
The expected output will be a series of status messages indicating that GitLab and its dependencies are being installed. Once the installation is complete, you can access GitLab by navigating to http:\/\/localhost<\/code> in your web browser.<\/p>\n
GitHub: The World’s Largest Open Source Community<\/h3>\n
GitHub is the world’s largest open source community and a platform for developers to collaborate on projects. While GitHub is primarily a cloud-based service, you can use GitHub’s command-line interface, GitHub CLI, to interact with GitHub from your Linux system.<\/p>\n
To install GitHub CLI on Ubuntu, you can use the following commands:<\/p>\n
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key C99B11DEB97541F0\nsudo apt-add-repository https:\/\/cli.github.com\/packages\nsudo apt update\nsudo apt install gh\n<\/code><\/pre>\n
The expected output will be a series of status messages indicating that GitHub CLI is being installed. Once the installation is complete, you can start using GitHub CLI by typing gh<\/code> in your terminal.<\/p>\n
Choosing the Right Git Service<\/h3>\n
While Gitea, GitLab, and GitHub all offer robust Git services, the best one for you depends on your specific needs. If you’re looking for a lightweight, self-hosted solution, Gitea is an excellent choice. If you need a comprehensive DevOps platform, consider GitLab. If you want to collaborate with the world’s largest open source community, GitHub is the way to go.<\/p>\n
Troubleshooting Gitea Installations<\/h2>\n
Installing Gitea on Linux is generally a smooth process, but like any software installation, you might encounter some issues. Here, we’ll discuss common problems and their solutions, along with some tips for a successful installation.<\/p>\n
Issue: Permission Denied<\/h3>\n
One common issue when installing Gitea is a ‘Permission Denied’ error. This typically happens when you try to execute the Gitea binary without the necessary permissions.<\/p>\n
To solve this issue, you need to make the binary executable using the chmod<\/code> command. Here’s how:<\/p>\n
chmod +x gitea\n<\/code><\/pre>\n
This command changes the permissions of the gitea<\/code> file and makes it executable. After running this command, you should be able to start the Gitea service without any ‘Permission Denied’ errors.<\/p>\n
Issue: Gitea Service Not Starting<\/h3>\n
Sometimes, after installing Gitea and making the binary executable, the Gitea service might not start when you run .\/gitea web<\/code>. This could be due to various reasons, such as port conflicts or insufficient system resources.<\/p>\n
To troubleshoot this issue, you can check the Gitea log file, which is typically located at \/var\/log\/gitea\/gitea.log<\/code>:<\/p>\n
cat \/var\/log\/gitea\/gitea.log\n<\/code><\/pre>\n
This command will display the contents of the log file, which should give you clues about why the Gitea service isn’t starting.<\/p>\n
Considerations for a Smooth Installation<\/h3>\n
When installing Gitea on Linux, consider the following tips for a smooth installation:<\/p>\n