groales/gitea
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Page: Configuración Inicial
Pages
Actualización Backup y Restauración Configuración Inicial Home NPM Personalización Solución de Problemas Traefik
Clone
Configuración Inicial
groales edited this page 2025-12-03 16:27:25 +01:00
Unescape Escape
Table of Contents
This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Configuración Inicial

Después de desplegar Gitea, debes completar el asistente de instalación inicial para configurar la aplicación.

🌐 Acceso al Asistente

Visita https://gitea.tudominio.com en tu navegador. La primera vez verás el asistente de instalación de Gitea.

🗄️ 1. Configuración de Base de Datos

Esta sección ya está pre-configurada gracias a las variables de entorno del compose:

Configuración (pre-rellenada automáticamente):

  • Tipo de base de datos: PostgreSQL
  • Host: gitea-db:5432
  • Nombre de usuario: gitea (o el valor de DB_USER)
  • Contraseña: La que configuraste en DB_PASSWORD
  • Nombre de base de datos: gitea (o el valor de DB_NAME)

⚠️ Importante: Verifica que estos valores coinciden con tu archivo .env.

⚙️ 2. Configuración General del Sitio

Configura los parámetros generales de tu instalación Gitea:

Título del Sitio

Campo: Site Title
Valor recomendado: Git ICT Iberia o el nombre de tu organización

Aparecerá en la interfaz web, emails y notificaciones.

URL Base del Servidor

Campo: Server Domain y Gitea Base URL
Valores críticos:

  • Server Domain: gitea.tudominio.com
  • Gitea Base URL: https://gitea.tudominio.com

⚠️ MUY IMPORTANTE:

  • Debe incluir https://
  • Si usas un puerto diferente a 443, inclúyelo: https://gitea.tudominio.com:8443
  • Esta URL se usa para clonado de repos y webhooks

Rutas de Archivos

Valores por defecto (recomendados):

  • Ruta de repositorios Git: /data/git/repositories
  • Ruta raíz Git LFS: /data/git/lfs
  • Ejecutar como nombre de usuario: git

✅ No cambies estas rutas a menos que sepas lo que haces.

SSH

Puerto del servidor SSH: 22

Gitea puede servir SSH en el puerto 22 del contenedor. Para usarlo desde fuera:

  • Con Traefik/NPM: Necesitas publicar el puerto SSH separadamente (no cubierto en este stack básico)
  • Alternativa: Usar HTTPS para git (más simple, funciona directamente)

👤 3. Configuración del Administrador

Crea tu cuenta de administrador:

Nombre de Usuario

Campo: Administrator Username
Valor: Tu nombre de usuario preferido (ej: admin, groales)

Este será el primer usuario y tendrá permisos de administrador completos.

Contraseña

Campo: Password y Confirm Password
Recomendaciones:

  • ✅ Mínimo 12 caracteres
  • ✅ Combina mayúsculas, minúsculas, números y símbolos
  • ✅ No reutilices contraseñas de otros servicios

Email

Campo: Email Address
Valor: Tu email real

Úsalo para:

  • Recuperación de contraseña
  • Notificaciones (si configuras SMTP)
  • Webhooks y alertas

⚙️ 4. Configuración Opcional

Antes de hacer clic en "Install", puedes expandir Optional Settings para ajustes adicionales.

Configuración de Email

Si tienes un servidor SMTP, configúralo ahora:

  • Server and Other Services → Email Settings:
    • SMTP Host: smtp.tudominio.com
    • SMTP Port: 587 (STARTTLS) o 465 (SSL)
    • Send Email As: gitea@tudominio.com
    • SMTP Username: Tu usuario SMTP
    • SMTP Password: Tu contraseña SMTP

ℹ️ También puedes configurar SMTP más tarde editando /data/gitea/conf/app.ini.

Configuración del Servidor

Ajustes opcionales en Server and Other Services:

  • Disable Self-Registration: ✅ Recomendado si es una instalación privada
  • Require Sign-In to View Pages: ✅ Activar para repositorios completamente privados
  • Enable OpenID Sign-In: ❌ Desactivar si no lo necesitas

Notificaciones

  • Enable Email Notifications: ✅ Activar si configuraste SMTP
  • Disable Gravatar Service: ❌ Dejar activado (usa avatares de Gravatar)

✅ 5. Completar Instalación

  1. Revisa que todo esté correcto
  2. Haz clic en Install Gitea
  3. Espera unos segundos mientras se configura

Si todo va bien, serás redirigido a la pantalla de login.

🔐 6. Primer Inicio de Sesión

  1. Introduce tu nombre de usuario y contraseña del administrador
  2. Haz clic en Sign In

¡Bienvenido a Gitea! Ya puedes empezar a crear repositorios.

🛠️ Post-Instalación

Verificar Configuración

Accede al panel de administración:

  1. Haz clic en tu avatar (esquina superior derecha)
  2. Selecciona Site Administration
  3. Revisa las secciones:
    • Dashboard: Estado general del sistema
    • Configuration: Ver configuración completa
    • Users: Gestionar usuarios

Crear tu Primer Repositorio

  1. Haz clic en el + en la esquina superior derecha
  2. Selecciona New Repository
  3. Configura:
    • Owner: Tu usuario
    • Repository Name: Nombre del proyecto
    • Visibility: Public/Private
    • ✅ Initialize Repository: Añade README, .gitignore, License
  4. Haz clic en Create Repository

Configurar SSH (Opcional)

Ver la sección SSH en la página Personalización.

📝 Notas Importantes

Archivo app.ini

La configuración de Gitea se guarda en:

/data/gitea/conf/app.ini

Para editarlo:

docker compose exec gitea vi /data/gitea/conf/app.ini

# Después de editar, reiniciar Gitea
docker compose restart gitea

Cambiar URL Base Después

Si necesitas cambiar la URL base después de la instalación:

  1. Edita /data/gitea/conf/app.ini
  2. Busca [server]
  3. Modifica: 
    DOMAIN = gitea.tudominio.com
ROOT_URL = https://gitea.tudominio.com/
  4. Reinicia: docker compose restart gitea

Primer Usuario = Admin

El primer usuario que crees automáticamente tiene permisos de administrador. Si deshabilitaste auto-registro, solo tú podrás crear tu cuenta.

🆘 Solución de Problemas

"Database connection failed"

Causa: Gitea no puede conectar a PostgreSQL

Solución:

# Verificar que gitea-db está corriendo
docker compose ps

# Ver logs de PostgreSQL
docker compose logs gitea-db

# Verificar que están en la red gitea-internal
docker network inspect gitea-internal

"Cannot save configuration"

Causa: Permisos incorrectos en el volumen

Solución:

# Verificar permisos
docker compose exec gitea ls -la /data/gitea

# Si es necesario, recrear el volumen
docker compose down
docker volume rm gitea_data
docker compose up -d

No puedo acceder a https://gitea.tudominio.com

Causa: Problema con el proxy inverso

Solución:

  • Traefik: Verifica labels en el contenedor: docker inspect gitea
  • NPM: Verifica que el Proxy Host está configurado correctamente
  • Comprueba que el puerto 3000 está accesible: docker compose exec gitea netstat -ln | grep 3000

Siguiente paso: Personalización

📚 Wiki de Gitea

Inicio

🚀 Despliegue

⚙️ Configuración

🔧 Mantenimiento

📖 Enlaces Útiles

Última actualización: Diciembre 2025