Installing Gitea on Windows 10

Gitea is a self-hosted Git service written in Go, similar to GitHub and GitLab. In this tutorial, we will be installing Gitea on a Windows 10 machine.

Prerequisites

Before installing Gitea, ensure that you have the following prerequisites:

  • A Windows 10 machine with administrative privileges
  • Git Bash installed on your machine
  • MySQL or PostgreSQL server installed on your machine

Step 1: Download Gitea

Download the latest stable version of Gitea from the official website using the following link:

https://dl.gitea.io/gitea/

Step 2: Extract the Gitea package

Extract the Gitea package into a directory of your choice. You can use tools like 7zip or WinRAR to extract the package.

Step 3: Create a database

Gitea requires a database to store its data. You can use either MySQL or PostgreSQL. Follow the steps given below to create a database using MySQL:

  1. Open a command prompt window and navigate to the directory where you installed MySQL.

  2. Type the following command to log in to the MySQL server:

    mysql -u root -p
    
  3. Enter the root password when prompted.

  4. Type the following command to create a new database:

    CREATE DATABASE gitea;
    
  5. Type the following command to create a new user:

    CREATE USER 'gitea' IDENTIFIED BY 'password';
    
  6. Grant all privileges to the gitea user by typing the following command:

    GRANT ALL PRIVILEGES ON gitea.* TO 'gitea';
    

    Note: Replace 'password' with a secure password of your choice.

Step 4: Configure Gitea

Open a Git Bash window and navigate to the directory where you extracted the Gitea package. Type the following command to launch the Gitea web installer:

./gitea web -c app.ini

The installer will prompt you to configure the database settings. Provide the following details:

  • Database Type: Choose either MySQL or PostgreSQL, depending on your database server.
  • Host: The hostname or IP address of the server.
  • Port: The port on which the database server is listening.
  • User: The username of the database user you created.
  • Password: The password of the database user you created.
  • Database Name: The name of the database you created.

After you have entered these details, click on the 'Test Database Connection' button to ensure that the connection is successful. If the connection is successful, click on the 'Install Gitea' button to proceed.

Step 5: Launch Gitea

After the installation is complete, you can launch Gitea by typing the following command into the Git Bash window:

./gitea web -c app.ini

This will launch the Gitea server, and you can access it by opening a web browser and navigating to http://localhost:3000/.

Conclusion

In this tutorial, we have seen how to install Gitea on a Windows 10 machine. You can now use this self-hosted Git service to manage your code repositories. Happy coding!