groales/gitea

Table of Contents

Wiki de Gitea

📋 Índice de Contenidos

Despliegue
Configuración y Mantenimiento

🔧 ¿Qué es Gitea?
⚠️ Consideraciones Importantes
🔑 Generar DB_PASSWORD
🚀 Inicio Rápido

Elección del Modo de Despliegue
Variables de Entorno

📚 Recursos Adicionales
🆘 Soporte

Wiki de Gitea

Bienvenido a la wiki de Gitea, un servidor Git autoalojado ligero y rápido.

📋 Índice de Contenidos

Despliegue

Traefik: Despliegue con Traefik como reverse proxy (requiere override)
Nginx Proxy Manager: Despliegue con Nginx Proxy Manager (usa compose base)

Configuración y Mantenimiento

Configuración Inicial: Asistente de instalación y primeros pasos
Personalización: SMTP, SSH, webhooks, integración CI/CD
Backup y Restauración: Protege tus repositorios
Actualización: Mantener Gitea actualizado
Solución de Problemas: Resolver errores comunes

🔧 ¿Qué es Gitea?

Gitea es un servidor Git autoalojado escrito en Go. Es una alternativa ligera a GitLab y GitHub on-premises que ofrece:

🚀 Ligero y rápido: Consume menos de 100MB de RAM
📦 Fácil de instalar: Un solo binario, no requiere Node.js ni Ruby
🔒 Seguro y confiable: Gestión completa de permisos y accesos
📱 Interfaz moderna: UI similar a GitHub, intuitiva y responsive
🔄 Git completo: Pull requests, issues, wiki, projects, CI/CD

⚠️ Consideraciones Importantes

Antes de desplegar Gitea:

PostgreSQL incluido: Este stack incluye PostgreSQL 16 Alpine
Contraseña segura: Genera DB_PASSWORD fuerte para la base de datos
Backups esenciales: Un servidor Git sin backups es un riesgo crítico
HTTPS recomendado: Para push/pull seguro y autenticación
Usuario administrador: El primer usuario creado es automáticamente admin
URL base correcta: Debe configurarse en el asistente inicial con HTTPS

🔑 Generar DB_PASSWORD

Antes de cualquier despliegue, genera una contraseña segura para PostgreSQL:

openssl rand -base64 32

Guarda el resultado, lo necesitarás como DB_PASSWORD.

⚠️ Importante: Usa comillas simples en el archivo .env si contiene caracteres especiales. Ejemplo: DB_PASSWORD='tu_password_generado'

🚀 Inicio Rápido

Elección del Modo de Despliegue

Modo	Recomendado	Requisitos	Características
Traefik	✅ Sí	Red `proxy`, Traefik con Let's Encrypt	SSL automático, configuración simple
NPM	✅ Sí	Red `proxy`, NPM configurado	Configuración manual de proxy host

Variables de Entorno

Todas las configuraciones requieren:

DB_PASSWORD='tu_password_generado'  # Contraseña PostgreSQL (entre comillas simples)

Para Traefik necesitas también:

DOMAIN_HOST=gitea.tudominio.com      # Sin protocolo

Opcionales (tienen valores por defecto):

DB_NAME=gitea       # Nombre de la base de datos (default: gitea)
DB_USER=gitea       # Usuario PostgreSQL (default: gitea)

📚 Recursos Adicionales

🆘 Soporte

Si encuentras problemas:

Consulta la página Solución de Problemas
Revisa los logs: docker compose logs gitea o docker compose logs gitea-db
Verifica la configuración en /data/gitea/conf/app.ini
Consulta la documentación oficial de Gitea

Última actualización: Diciembre 2025

📚 Wiki de Gitea

Inicio

🏠 Home

🚀 Despliegue

⚙️ Configuración

🔧 Mantenimiento

📖 Enlaces Útiles

Última actualización: Diciembre 2025