Gitea

Key Features

• GitHub-like web interface with repository browsing, file editing, and commit history visualization
• Built-in CI/CD through Gitea Actions with GitHub Actions compatibility for existing workflows
• Comprehensive issue tracking system with labels, milestones, and project boards for agile development
• Pull request workflow with code review, inline comments, and merge conflict resolution
• PostgreSQL backend providing ACID compliance and robust data integrity for all Git metadata
• SSH Git access on port 222 alongside HTTPS for flexible repository cloning and pushing
• Package registry support for Docker, npm, PyPI, and other package formats
• Repository migration tools for importing from GitHub, GitLab, and other Git services

Common Use Cases

• 1Private Git hosting for software development teams requiring code privacy and control
• 2DevOps environments needing integrated CI/CD pipelines with GitHub Actions compatibility
• 3Educational institutions providing Git services for programming courses and student projects
• 4Open source project hosting for communities wanting self-managed infrastructure
• 5Enterprise development teams migrating from cloud Git services to on-premises solutions
• 6Homelab environments for personal project management and portfolio development
• 7Compliance-sensitive organizations requiring air-gapped or geographically restricted code hosting

Prerequisites

• Docker and Docker Compose installed on the host system
• Minimum 768MB RAM available (256MB for PostgreSQL, 512MB for Gitea application)
• Ports 3000 (HTTP) and 222 (SSH) available and not conflicting with existing services
• DB_PASSWORD environment variable configured in .env file or system environment
• Basic understanding of Git operations and repository management concepts
• SSH client configured if using SSH-based Git operations on port 222

docker-compose.yml

1services: 
2  gitea: 
3    image: gitea/gitea:latest
4    container_name: gitea
5    restart: unless-stopped
6    environment: 
7      USER_UID: 1000
8      USER_GID: 1000
9      GITEA__database__DB_TYPE: postgres
10      GITEA__database__HOST: db:5432
11      GITEA__database__NAME: gitea
12      GITEA__database__USER: gitea
13      GITEA__database__PASSWD: ${DB_PASSWORD}
14    volumes: 
15      - gitea_data:/data
16    ports: 
17      - "3000:3000"
18      - "222:22"
19    depends_on: 
20      - db
21
22  db: 
23    image: postgres:15-alpine
24    container_name: gitea-db
25    environment: 
26      POSTGRES_USER: gitea
27      POSTGRES_PASSWORD: ${DB_PASSWORD}
28      POSTGRES_DB: gitea
29    volumes: 
30      - gitea_db:/var/lib/postgresql/data
31
32volumes: 
33  gitea_data: 
34  gitea_db: 

.env Template

1DB_PASSWORD=changeme

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

gitea:
  image: gitea/gitea:latest
  container_name: gitea
  restart: unless-stopped
  environment:
    USER_UID: 1000
    USER_GID: 1000
    GITEA__database__DB_TYPE: postgres
    GITEA__database__HOST: db:5432
    GITEA__database__NAME: gitea
    GITEA__database__USER: gitea
    GITEA__database__PASSWD: ${DB_PASSWORD}
  volumes:
    - gitea_data:/data
  ports:
    - "3000:3000"
    - "222:22"
  depends_on:
    - db

db:
  image: postgres:15-alpine
  container_name: gitea-db
  environment:
    POSTGRES_USER: gitea
    POSTGRES_PASSWORD: ${DB_PASSWORD}
    POSTGRES_DB: gitea
  volumes:
    - gitea_db:/var/lib/postgresql/data

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  gitea:
5    image: gitea/gitea:latest
6    container_name: gitea
7    restart: unless-stopped
8    environment:
9      USER_UID: 1000
10      USER_GID: 1000
11      GITEA__database__DB_TYPE: postgres
12      GITEA__database__HOST: db:5432
13      GITEA__database__NAME: gitea
14      GITEA__database__USER: gitea
15      GITEA__database__PASSWD: ${DB_PASSWORD}
16    volumes:
17      - gitea_data:/data
18    ports:
19      - "3000:3000"
20      - "222:22"
21    depends_on:
22      - db
23
24  db:
25    image: postgres:15-alpine
26    container_name: gitea-db
27    environment:
28      POSTGRES_USER: gitea
29      POSTGRES_PASSWORD: ${DB_PASSWORD}
30      POSTGRES_DB: gitea
31    volumes:
32      - gitea_db:/var/lib/postgresql/data
33
34volumes:
35  gitea_data:
36  gitea_db:
37EOF
38
39# 2. Create the .env file
40cat > .env << 'EOF'
41DB_PASSWORD=changeme
42EOF
43
44# 3. Start the services
45docker compose up -d
46
47# 4. View logs
48docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/gitea/run | bash

Troubleshooting