# Gitea

![git](git.png)

<div class="github-widget" data-repo="go-gitea/gitea"></div>

Self-hosted Git service for collaborative development.

## Overview

Gitea is a lightweight, self-hosted Git service similar to GitHub, GitLab, and Bitbucket. It provides a web interface for managing repositories, issues, pull requests, and more.

## Features

- Git repository hosting
- Web-based interface
- Issue tracking
- Pull requests
- Wiki and code review
- Lightweight and easy to deploy

## Access

- **Default Web Port**: `${GITEA_WEB_PORT:-3030}` (default: 3030)
- **Default SSH Port**: `${GITEA_SSH_PORT:-2222}` (default: 2222)
- **URL**: `http://localhost:${GITEA_WEB_PORT:-3030}`
- **Default Data Directory**: `/data/gitea`

## Configuration

### Environment Variables

- `GITEA__database__DB_TYPE`: Database type (e.g., `sqlite3`, `mysql`, `postgres`)
- `GITEA__database__HOST`: Database host (default: `${GITEA_DB_HOST:-gitea-db:3306}`)
- `GITEA__database__NAME`: Database name (default: `${GITEA_DB_NAME:-gitea}`)
- `GITEA__database__USER`: Database user (default: `${GITEA_DB_USER:-gitea}`)
- `GITEA__database__PASSWD`: Database password (from `.env`)
- `GITEA__server__ROOT_URL`: Root URL (e.g., `${GITEA_ROOT_URL}`)
- `GITEA__server__HTTP_PORT`: Web port (default: 3000 inside container)
- `GITEA__server__DOMAIN`: Domain (e.g., `${GITEA_DOMAIN}`)

### Volumes

- `gitea_data:/data`: Gitea configuration and data
- `/etc/timezone:/etc/timezone:ro`
- `/etc/localtime:/etc/localtime:ro`

## Usage

1. Access Gitea at `http://localhost:${GITEA_WEB_PORT:-3030}`
2. Register or log in as an admin user
3. Create or import repositories
4. Collaborate with your team

## Official Documentation

For more details, visit the [official Gitea documentation](https://docs.gitea.com/).