Personalización
Configuraciones avanzadas y personalización de tu instancia de Gitea.
📧 Configuración de Email (SMTP)
Para notificaciones, recuperación de contraseñas y webhooks.
Editar app.ini
docker compose exec gitea vi /data/gitea/conf/app.ini
Añade o modifica la sección [mailer]:
[mailer]
ENABLED = true
FROM = gitea@tudominio.com
MAILER_TYPE = smtp
HOST = smtp.tudominio.com:587
IS_TLS_ENABLED = true
USER = gitea@tudominio.com
PASSWD = tu_password_smtp
Para Gmail:
HOST = smtp.gmail.com:587
USER = tu_email@gmail.com
PASSWD = tu_app_password
Reinicia Gitea:
docker compose restart gitea
🔑 Configuración de SSH
Generar Clave SSH (Cliente)
ssh-keygen -t ed25519 -C "tu_email@ejemplo.com"
cat ~/.ssh/id_ed25519.pub
Añadir Clave en Gitea
- Ve a Settings → SSH / GPG Keys
- Haz clic en Add Key
- Pega tu clave pública
- Haz clic en Add Key
Clonar con SSH
git clone git@gitea.tudominio.com:usuario/repo.git
⚠️ Nota: Este stack básico no expone el puerto SSH (22). Para usar SSH, necesitas publicar el puerto 22 del contenedor.
🔗 Webhooks
Configura notificaciones cuando ocurren eventos en tus repositorios.
Crear Webhook
- Ve al repositorio → Settings → Webhooks
- Haz clic en Add Webhook → Selecciona tipo (Gitea, Discord, Slack, etc.)
- Configura:
- Target URL: URL de tu servicio
- HTTP Method: POST (generalmente)
- Content Type: application/json
- Secret: Token de seguridad (opcional pero recomendado)
- Selecciona eventos que disparan el webhook
- Haz clic en Add Webhook
👥 Gestión de Usuarios
Desde Panel de Administración
Site Administration → User Accounts:
- Create User Account: Crear usuarios manualmente
- Edit: Modificar usuarios existentes
- Delete: Eliminar usuarios
Deshabilitar Auto-Registro
Edita app.ini:
[service]
DISABLE_REGISTRATION = true
REQUIRE_SIGNIN_VIEW = true # Requiere login para ver contenido
Cambiar a Usuario Admin
docker compose exec gitea gitea admin user change-password --username usuario --password nueva_password
🎨 Personalización Visual
Logo y Favicon
- Coloca tus archivos en el volumen
gitea_data - Edita
app.ini:
[ui]
DEFAULT_THEME = gitea
THEMES = gitea,arc-green
Mensaje de Bienvenida
Crea un archivo Markdown en:
/data/gitea/custom/templates/home.tmpl
📊 Integración CI/CD
Gitea soporta Gitea Actions (compatible con GitHub Actions).
Habilitar Gitea Actions
Edita app.ini:
[actions]
ENABLED = true
Añadir Runner
Necesitas un contenedor adicional act_runner. Ver documentación oficial.
🔒 Autenticación Externa
LDAP/Active Directory
Site Administration → Authentication Sources → Add Authentication Source
Selecciona LDAP (via BindDN) y configura:
- Host
- Port
- Bind DN
- User Search Base
- User Filter
OAuth2 (Google, GitHub, etc.)
Site Administration → Authentication Sources → OAuth2
Configura el provider y las credenciales OAuth2.
📝 Configuración de Repositorios
Límites de Tamaño
Edita app.ini:
[repository]
ROOT = /data/git/repositories
DEFAULT_BRANCH = main
[repository.upload]
FILE_MAX_SIZE = 50
Git LFS
[lfs]
STORAGE_TYPE = local
PATH = /data/git/lfs
🛡️ Seguridad
2FA (Two-Factor Authentication)
- Usuario → Settings → Security
- Two-Factor Authentication
- Escanea QR con app (Google Authenticator, Authy)
- Introduce código de verificación
Tokens de Acceso
Settings → Applications → Generate New Token
Úsalos para:
- API de Gitea
- CI/CD pipelines
- Automatización
🌐 Internacionalización
Gitea soporta múltiples idiomas. Cambia en:
Settings → Account → Language
Ver Backup y Restauración para proteger tu configuración.
📚 Wiki de Gitea
Inicio
🚀 Despliegue
⚙️ Configuración
🔧 Mantenimiento
📖 Enlaces Útiles
Última actualización: Diciembre 2025