Gitea is an alternative to GitHub and GitLab that allows you to manage repositories, perform merge requests, validate code, and track bugs. Gitea also has a built-in CI/CD tool Gitea Actions, compatible with GitHub Actions.
An important advantage of Gitea is the ability to migrate repositories and related data from other Git services in just a few clicks. Gitea Git service can also be used as a mirror for remote repositories, including configuring synchronization options and its interval.
The project management functionality is similar to GitHub and supports features such as:
- tags;
- stages;
- wikis;
- runtime tracking;
- role assignment, etc.
CI/CD is handled by Gitea Runner and allows you to create and execute your own pipelines.
Beget VPS with pre-installed Gitea is a ready-to-use development platform deployed on your server with a domain of your choice and an SSL certificate.
Installation package information
- Ubuntu 24.04
- Docker
- Certbot
- Gitea
Gitea installation
The following information will be required before the installation can begin:
- Domain name by which Gitea will be accessible. You can either choose your domain or register a new one. Alternatively, you can use the free
.beget.appdomain. A free SSL certificate will be installed on this domain. - Admin Email. This email will be used to access Gitea.
- Admin Password. This password will be used to access Gitea.
Once the server is created and the application is installed, you will receive a notification with login details to the specified email.
Getting Started
To get started go to https://domain.beget.app/, where domain.beget.app is the domain of your choice.
To log in, use the email and password specified when creating the server.
Migration of repositories
To start the migration, click on the button in the upper right corner and select “New Migration”.
Select the desired source. After choosing a source you will be able to specify the repository address and migration options. If you want your repository to be a mirror of a remote repository, activate the “This repository will be a mirror” option. After specifying the options, click the “Migrate Repository” button.
FAQ
Before upgrading, we recommend checking if you have an up-to-date backup in the “Backup” section or making a VPS/VDS snapshot in the “Snapshots” section to be able to roll back the changes.
To upgrade your Gitea to the desired version, follow the steps below:
- Connect to the server via SSH.
- Navigate to the Gitea directory using
cd /opt/beget/giteacommand. - Open the
docker-compose.ymlfile with a text editor of your choice. - Find the line
image: gitea/gitea:1.21.Xand change the Gitea version to the desired version, save the changes and close the file. Example of changes:image: gitea/gitea:1.21.8 - Download the new version image with the
docker compose pullcommand. - Stop the current version of Gitea with the
docker compose downcommand. - Start the new version of Gitea with the
docker compose up -dcommand. - Wait 2–5 minutes for Gitea to migrate to the new version and start.
- Test the new Gitea version.
The files and configuration data, as well as the repositories, are located in the /opt/beget/gitea directory
Gitea configuration file: /opt/beget/gitea/gitea/gitea/conf/app.ini
Container configuration: /opt/beget/gitea/docker-compose.yml
- Connect to the server via SSH.
- Navigate to the directory with the command
cd /opt/beget/gitea. - Run the command:
docker compose restart.
Since Gitea runs inside the docker container, it is not possible to simply run the CLI by connecting via SSH. Follow these steps to execute the commands:
- Connect to the server via SSH.
- Use the following template to run the command:
docker exec -u git -it gitea <CLI command>, for example:docker exec -u git -it gitea gitea help.
The Gitea CLI documentation can be found on the official website.
