{"id":3178,"date":"2025-12-18T05:20:51","date_gmt":"2022-11-22T18:03:08","guid":{"rendered":""},"modified":"2025-02-02T00:46:19","modified_gmt":"2025-02-01T23:46:19","slug":"how-to-install-gitea-on-ubuntu-22-04","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/knowledgebase\/how-to-install-gitea-on-ubuntu-22-04\/","title":{"rendered":"Linux VPS & VPS Windows Setup Guide | NetCloud24 Gitea on Ubuntu 22.04"},"content":{"rendered":"

\u00a0<\/p>\n<\/p>\n

\n

\u00a0<\/h1>\n<\/header>\n
\n

Gitea is a lightweight, self-hosted Git service that allows you to manage repositories with ease. In this guide, we will walk you through the installation of Gitea on Ubuntu 22.04. Whether you are deploying it on a local server or using a Windows VPS <\/a>, this tutorial covers all the necessary steps.<\/p>\n

\n

Step 1: Update Your System<\/h2>\n

Before installing Gitea, ensure your system is up to date. Run the following commands:<\/p>\n

sudo apt update && sudo apt upgrade -y<\/code><\/pre>\n
Keeping your system updated is crucial for security and performance, whether you’re setting it up locally or on a VPS Windows VPS Servers<\/a> platform.<\/p>\n<\/section>\n
\n
Step 2: Install Required Dependencies<\/h2>\n
Install the necessary dependencies for Gitea:<\/p>\n
sudo apt install -y git mariadb-server<\/code><\/pre>\n<\/section>\n
\n
Step 3: Configure MariaDB<\/h2>\n
Start the MariaDB service and secure it:<\/p>\n
\r\nsudo systemctl start mariadb\r\nsudo mysql_secure_installation\r\n            <\/code><\/pre>\n
Log in to the MariaDB console:<\/p>\n
sudo mysql -u root -p<\/code><\/pre>\n
Create a new database and user for Gitea:<\/p>\n
\r\nCREATE DATABASE gitea;\r\nCREATE USER 'giteauser'@'localhost' IDENTIFIED BY 'your_password';\r\nGRANT ALL PRIVILEGES ON gitea.* TO 'giteauser'@'localhost';\r\nFLUSH PRIVILEGES;\r\nEXIT;\r\n            <\/code><\/pre>\n
Replace your_password<\/code> with a strong password of your choice.<\/p>\n<\/section>\n
\n
Step 4: Download Gitea<\/h2>\n
Create a directory for Gitea and download the latest release:<\/p>\n
\r\nsudo mkdir -p \/var\/lib\/gitea\/{custom,data,log}\r\nsudo chown -R $(whoami):$(whoami) \/var\/lib\/gitea\r\ncd \/tmp\r\nwget https:\/\/dl.gitea.io\/gitea\/latest\/gitea-latest-linux-amd64\r\nsudo mv gitea-latest-linux-amd64 \/usr\/local\/bin\/gitea\r\nsudo chmod +x \/usr\/local\/bin\/gitea\r\n            <\/code><\/pre>\n<\/section>\n
\n
Step 5: Create a Gitea Service<\/h2>\n
Create a systemd service file for Gitea:<\/p>\n
sudo nano \/etc\/systemd\/system\/gitea.service<\/code><\/pre>\n
Add the following content to the file:<\/p>\n
\r\n[Unit]\r\nDescription=Gitea\r\nAfter=network.target\r\n\r\n[Service]\r\nUser=your_username\r\nGroup=your_username\r\nWorkingDirectory=\/var\/lib\/gitea\r\nExecStart=\/usr\/local\/bin\/gitea web\r\nRestart=always\r\nEnvironment=USER=your_username\r\nEnvironment=HOME=\/var\/lib\/gitea\r\n\r\n[Install]\r\nWantedBy=multi-user.target\r\n            <\/code><\/pre>\n
Replace your_username<\/code> with your actual username. Save and exit the file.<\/p>\n<\/section>\n
\n
Step 6: Start Gitea<\/h2>\n
Enable and start the Gitea service:<\/p>\n
\r\nsudo systemctl enable gitea\r\nsudo systemctl start gitea\r\n            <\/code><\/pre>\n<\/section>\n
\n
Step 7: Configure Nginx as a Reverse Proxy (Optional)<\/h2>\n
If you want to run Gitea behind Nginx, first install Nginx:<\/p>\n
sudo apt install nginx -y<\/code><\/pre>\n
Create a new Nginx configuration file for Gitea:<\/p>\n
sudo nano \/etc\/nginx\/sites-available\/gitea<\/code><\/pre>\n
Add the following configuration, replacing your_domain.com<\/code> with your actual domain:<\/p>\n
\r\nserver {\r\n    listen 80;\r\n    server_name your_domain.com;\r\n\r\n    location \/ {\r\n        proxy_pass http:\/\/localhost:3000;\r\n        proxy_set_header Host $host;\r\n        proxy_set_header X-Real-IP $remote_addr;\r\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\r\n        proxy_set_header X-Forwarded-Proto $scheme;\r\n    }\r\n}\r\n            <\/code><\/pre>\n
Save and exit the file, then create a symlink to enable the configuration:<\/p>\n
sudo ln -s \/etc\/nginx\/sites-available\/gitea \/etc\/nginx\/sites-enabled\/<\/code><\/pre>\n
Test the Nginx configuration for syntax errors:<\/p>\n
sudo nginx -t<\/code><\/pre>\n
If everything is okay, restart Nginx:<\/p>\n
sudo systemctl restart nginx<\/code><\/pre>\n<\/section>\n
\n
Step 8: Access Gitea<\/h2>\n
Open your web browser and navigate to:<\/p>\n
http:\/\/your_domain.com<\/code><\/pre>\n
You should see the Gitea setup page. Follow the instructions to complete the installation.<\/p>\n<\/section>\n