Gitea

Introduction

Gitea is a lightweight, self-hosted Git service written in Go. This guide will walk you through setting up Gitea with Docker using docker-compose.

Setting Up Gitea with Docker

Create a Directory

mkdir gitea && cd gitea

Create docker-compose.yaml

version: '3'

services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    restart: unless-stopped
    environment:
      - USER_UID=1000
      - USER_GID=1000
    volumes:
      - ./gitea-data:/data
    ports:
      - "3000:3000"
      - "222:22" # If you expose SSH
    networks:
      - gitea

  gitea-act-runner:
    image: gitea/act_runner:latest
    container_name: gitea-act-runner
    restart: unless-stopped
    depends_on:
      - gitea
    environment:
      - CONFIG_FILE=/config.yaml
      - GITEA_INSTANCE_URL=http://gitea:3000
      - GITEA_RUNNER_REGISTRATION_TOKEN=REGISTRATION_TOKEN
      - GITEA_RUNNER_NAME=runner-1
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./gitea-runner-data:/data
      - ./gitea-runner-data/config.yaml:/config.yaml
    networks:
      - gitea
networks:
  gitea:

Start Gitea

docker-compose up -d

Installation

After starting the Docker setup, open your browser and visit http://server-ip:3000 to complete the installation via the web UI.

Customization

Customization files should be placed in the gitea/data directory as described in the official documentation.

Modify app.ini:

nano ./gitea/data/conf/app.ini

Example:

[server]
DISABLE_REGISTRATION = true # Disables registration so only admins can create accounts.

Restart Gitea for changes to take effect:

docker restart gitea

Setting Up a Runner (Optional)

To enable CI/CD workflows using Gitea Actions, set up a runner:

docker run --entrypoint="" --rm -it docker.io/gitea/act_runner:latest act_runner generate-config > gitea-runner-data/config.yaml

Edit config.yaml

container:
  network: "gitea_gitea"

example of workflow .gitea/workflows/demo.yaml

name: Deploy Container

on:
  push:
    branches:
      - master

jobs:
  build_and_deploy:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v2

    - name: Build Docker image
      run: |
        docker build -t my-app .

    - name: Deploy Container
      run: |
        docker stop my-app || true
        docker rm my-app || true
        docker run -d --name my-app -p 8080:8080 my-app

Conclusion

You now have a self-hosted Git service running with Gitea, and optional CI/CD support. Happy coding!