Imagen Docker
Gitea en Docker. Tu propio Git, un contenedor.
Gitea es un servicio Git autoalojado. Le da a un equipo su propio lugar para alojar repositorios, revisar pull requests, llevar issues, correr el CI integrado de Actions y publicar releases y paquetes, todo desde un binario liviano que corre cómodo en un servidor pequeño.
¿Prefieres no correrla tú? Gitea administrado desde $5/mes
# Gitea en Docker, base fijada por digest docker pull ghcr.io/remarkablecloud/gitea:1.27.3-r1 docker compose up -d
- Build actual
1.27.3-r1, actualizada 10 sept 2026- Base
- Gitea oficial, anclada por digest
- Qué trae
- Setup headless, SQLite, admin auto-provisionado, healthcheck
- Licencia de origen
- Gitea: MIT
La imagen
Qué agrega nuestra imagen.
Qué cambia frente a Gitea original, y por qué importa en producción.
Base anclada por digest
El build parte de gitea/gitea@sha256:87a67e... (Gitea 1.27.3). Anclar por digest significa que cada reconstrucción del tag 1.27.3-r1 resuelve exactamente a la misma capa upstream, que es lo que hace confiable el seguimiento de CVEs.
Admin provisionado en la primera corrida
Un entrypoint envoltorio espera a que la app reporte salud, crea una cuenta admin e imprime la contraseña generada una vez en el log del contenedor. Nunca tocas un instalador de navegador.
Healthcheck del contenedor
Un HEALTHCHECK consulta /api/healthz, así tu orquestador puede condicionar el tráfico a la disponibilidad y reiniciar el contenedor si Gitea deja de responder.
Headless por configuración
El catálogo entrega el install lock activado, registro público apagado, SQLite como base de datos y la URL pública derivada del hostname del despliegue, así que la instancia es privada y enlaza correcto desde la primera petición.
Etiquetas de procedencia
Etiquetas OCI estándar registran título, descripción, vendor y repositorio fuente. Todo lo que es Gitea en sí (funciones, formato de almacenamiento, internals de Git) es upstream sin modificar.
Córrela tú, o no
La misma imagen en los dos casos.
Descárgala y córrela donde quieras, o deja que corramos Gitea por ti en un servidor administrado con actualizaciones, monitoreo y snapshots.
Corre Gitea por tu cuenta
- Descárgala de GHCR y córrela en cualquier host Docker
- La guía de abajo: compose, entorno, respaldos, actualizaciones
- Tú la actualizas, respaldas y vigilas
Gitea en un servidor administrado
- Instalada por nosotros desde esta misma imagen, $0 por la app
- Actualizaciones con un snapshot antes, monitoreo y firewall administrado
- Un servidor de 1 GB desde $5/mes facturado anual, con espacio para más apps
La guía
Córrela en producción.
Un resumen para producción, escrito por quienes construyen la imagen. La guía técnica completa, con compose, entorno, endurecimiento, respaldos y actualizaciones, está en inglés.
Resumen de producción
Un solo contenedor con SQLite: repos, issues y configuración viven en el volumen /data, sin base de datos externa que operar. El admin se crea solo en el primer arranque y su contraseña sale una vez en el log; el instalador web nunca aparece (INSTALL_LOCK=true) y el registro público está cerrado. El clonado va por HTTPS (el puerto SSH no se publica por defecto). Respaldar /data es respaldar todo. Para actualizar, cambia al tag nuevo y recrea.
La guía técnica completa (Compose, variables, hardening, respaldos y upgrades) está disponible en inglés: ver la guía completa.
Changelog
Cada build se fija por digest y queda registrado aquí, así ves qué cambió antes de descargar un tag nuevo.
-
1.27.3-r1Actual 10 sept 2026 Build base. Gitea 1.27.3 de origen.
Gitea y otros nombres de productos son marcas de sus respectivos titulares. RemarkableCloud no está afiliada a ellos ni cuenta con su respaldo.
FAQ
Gitea en Docker: respuestas.
Respuestas cortas de quienes construyen y corren esta imagen.
¿Dónde está la contraseña de admin?
Se genera en la primera corrida y se imprime una vez en el log del contenedor. Corre docker compose logs gitea | grep '\\[rc\\]' justo después del primer arranque. Para fijarla tú, define GITEA_ADMIN_PASSWORD antes del primer arranque.
¿Cómo reinicio una contraseña de admin perdida?
Usa el CLI del propio Gitea dentro del contenedor: docker compose exec -u git gitea gitea admin user change-password --username admin --password 'NUEVA'
¿Puedo usar MySQL o PostgreSQL en vez de SQLite?
Esta imagen se entrega para el flujo SQLite (db_mode = none, sin base externa). SQLite va bien para equipos pequeños y medianos. Pasar a una base externa es posible con Gitea upstream pero está fuera de lo que esta imagen afina.
¿Por qué no puedo clonar por SSH?
El compose publica solo el puerto HTTP (3000). Gitea igual muestra URLs de clonado git@host, pero el puerto SSH no está publicado. Usa la URL HTTPS de clonado de la página del repositorio, o publica y configura SSH tú mismo.
¿Aparece alguna vez el asistente de instalación?
No. INSTALL_LOCK=true lo deshabilita. Toda la configuración entra por variables de entorno y el volumen /data.
Descárgala, o deja que la corramos.
La misma imagen corre Gitea en nuestros servidores administrados, con actualizaciones y monitoreo incluidos.