2025-06-30 21:38:14 -06:00

56 lines
1.7 KiB
Markdown

# Gitea
<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/).