Skip to main content

Personalización de Gitea: Temas y otros ajustes

Introducción

Este artículo recoge los pasos necesarios para personalizar Gitea mediante temas, logos, favicons y plantillas. Todo con Docker, sin complicaciones raras. Asume que tienes los datos montados como /mnt/data:/data en el contenedor.

Estructura de carpetas

Asegúrate de tener creada la carpeta public dentro del volumen de datos. Por ejemplo:

drwxr-xr-x user user 4.0 KB ... public

Temas personalizados

  1. Crea tu CSS personalizado, por ejemplo mi-tema.css.
  2. Copia el archivo a:
/mnt/data/public/assets/css/mi-tema.css
  1. Edita el archivo app.ini (en /mnt/data/conf/app.ini) y añade en [ui]:
[ui]
THEMES = gitea,arc-green,mi-tema
DEFAULT_THEME = mi-tema
  1. Reinicia Gitea:
docker-compose restart gitea
  1. Desde la interfaz, ve a Configuración > Cuenta y selecciona el tema.

Cambiar logo y favicon

  1. Prepara los archivos:

    • logo.svg
    • favicon.png

  2. Copia a:

/mnt/data/public/assets/img/logo.svg
/mnt/data/public/assets/img/favicon.png
  1. Reinicia el contenedor:
docker-compose restart gitea

Personalizar plantillas

  1. Crea o copia las plantillas a:
/mnt/data/public/templates
  1. Edita con cuidado (usa sintaxis de Go templates).
  2. Reinicia Gitea para aplicar los cambios.

Buenas prácticas

  • Haz cambios primero en un entorno de pruebas.
  • Guarda copia de los archivos originales.
  • Asegúrate de que todo lo que modifiques sea compatible con tu versión actual de Gitea.

Referencias

Back to top