Git

Installation of Gitea Using Docker with Existing PostgreSQL Database

Overview

Gitea is a lightweight, self-hosted Git service similar to GitHub. This installation uses Docker for containerization, ensuring portability and ease of management. The setup connects to an existing PostgreSQL database on the host machine, eliminating the need for a separate database container.

Key Components:

Docker and Docker Compose
Gitea Docker Image (gitea/gitea:latest)

Prerequisites

Docker and Docker Compose are installed.
Existing PostgreSQL database (e.g., giteadb) with a dedicated user (e.g., giteauser) and granted privileges.
PostgreSQL is configured for external connections.

Step-by-Step Execution Procedure

Step 1: Create Project Directory and docker-compose.yml

Create a directory and define the Docker Compose file as follows:

version: "3"networks: gitea: external: falseservices: gitea: image: gitea/gitea:latest container_name: gitea restart: always networks: - gitea environment: - GITEA__database__DB_TYPE=postgres - GITEA__database__HOST=host.docker.internal:5432 - GITEA__database__NAME=giteadb - GITEA__database__USER=giteauser - GITEA__database__PASSWD=strongpassword - USER_UID=1000 - USER_GID=1000 volumes: - ./gitea-data:/data - /etc/timezone:/etc/timezone:ro - /etc/localtime:/etc/localtime:ro ports: - "3000:3000" - "2222:22"

Step 2: Start the Container

Run the following command: