¿Olvidaste tu contraseña de Gitea y no te llega el correo de recuperación? Aquí la solución rápida y definitiva 🚀

en agosto 31, 2026

Montar tu propio servidor Git con Gitea en Docker es una excelente opción por su ligereza y control total sobre tus repositorios. Sin embargo, hay un problema común: si olvidas tu contraseña de administrador y das clic en “¿Olvidaste tu contraseña?”, el correo nunca llega.

¿La razón? Por defecto, Gitea viene con el servicio de correo (SMTP) desactivado.

Aquí te muestro cómo listar tus usuarios, recuperar el acceso de inmediato desde la terminal y dejar configurado el correo para el futuro.

1. Lista los usuarios registrados y cambia la contraseña (Sin correo)

No necesitas esperar ningún email ni saberte el nombre exacto de memoria. Puedes consultar los usuarios y restablecer la clave usando el CLI de Gitea dentro de tu contenedor Docker:

Bash

# 1. Identifica el nombre de tu contenedor
sudo docker ps

# 2. Lista todos los usuarios registrados en tu instancia
sudo docker exec -it -u git gitea_server gitea admin user list

# 3. Cambia la contraseña del usuario deseado
sudo docker exec -it -u git gitea_server gitea admin user change-password --username tu_usuario --password "TuNuevaClave123"

¡Listo! Ya puedes iniciar sesión en tu panel web con la nueva contraseña.

2. Configura el envío de correos (SMTP) para que no vuelva a pasar

Para que los correos de recuperación, notificaciones y confirmaciones funcionen en automático, solo debes editar el archivo app.ini de Gitea:

Abre el archivo de configuración dentro del contenedor:Bashsudo docker exec -it gitea_server vi /data/gitea/conf/app.ini
Añade o edita los bloques [mailer] y [service]:

Ini, TOML

[mailer]
ENABLED        = true
FROM           = "Gitea" <tu_correo@dominio.com>
PROTOCOL       = smtps
SMTP_ADDR      = smtp.tudominio.com
SMTP_PORT      = 465
USER           = tu_correo@dominio.com
PASSWD         = tu_contraseña_o_token
FORCE_TRUST_SERVER_CERT = false

[service]
DISABLE_REGISTRATION_PASSWORD_RESET = false