TeX Live en Docker

​

Docker

Docker ofrece una forma ligera y portátil de empaquetar y ejecutar aplicaciones en contenedores aislados. Al empaquetar la aplicación junto con todas las dependencias necesarias, un contenedor garantiza un comportamiento coherente en distintas máquinas, desde portátiles hasta servidores de producción.

TeX Live es potente, pero grande y sensible a las diferencias a nivel de sistema. Empaquetar TeX Live dentro de una imagen Docker hace que la cadena de herramientas de LaTeX sea predecible, reproducible y fácil de distribuir.

Sin embargo, algunos paquetes de TeX Live dependen del acceso a la shell. Por motivos de seguridad, el contenedor debe ejecutarse en un entorno restringido que impida a los usuarios ejecutar comandos de shell arbitrarios (por ejemplo, mediante \write18 o shell escape). Este aislamiento protege el sistema anfitrión y evita accesos no deseados al sistema de archivos subyacente del contenedor o a herramientas como bash.

​

Edición completa de TeXLive

TeXLive-Full@ayaka-notes es una imagen Docker de TeXLive completa, diseñada para la compilación de LaTeX en sandbox en Ayakaleaf Pro, Overleaf CEP o entornos independientes de compilación de LaTeX.

Esta imagen pretende ofrecer una distribución de TeXLive casi completa, con fuentes y herramientas comunes preinstaladas, para minimizar los fallos de compilación causados por paquetes o fuentes ausentes. Nota: esta imagen Docker no contiene ningún componente de sharelatex/overleaf. Se usa para la compilación de Overleaf/Overleaf Pro.

​

Características:

• 🚀 Compatible con las arquitecturas de servidor x86_64 y arm64
• 📦 Instalación de TeXLive completa y optimizada
• 🧩 Fuentes y utilidades comunes preinstaladas
• 🐳 Lista para usar con Docker y Docker Compose
• 🧪 Probada con Overleaf Server Pro / Overleaf Pro
• 🔄 Actualizada periódicamente con las últimas versiones de TeXLive
• 🏷 Etiquetas para varias versiones de TeXLive (de 2020 a la más reciente)
• 🧑‍🔬 Compatibilidad con Knitr para código R en documentos LaTeX

​

Uso con Ayakaleaf Pro

TeX Live Full de Ayaka-notes está diseñado especialmente para ayakaleaf-pro; si eres usuario del toolkit, puedes añadir las siguientes variables de entorno al archivo config/variables.env.

Por ejemplo:

config/variables.env

ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1

​

Versiones de TeX Live

Gracias a GitHub Actions, podemos construir todas las imágenes de TeX en paralelo, entre ellas:

• ghcr.io/ayaka-notes/texlive-full:2026.1 (también con la etiqueta latest)
• ghcr.io/ayaka-notes/texlive-full:2025.1
• ghcr.io/ayaka-notes/texlive-full:2024.1
• ghcr.io/ayaka-notes/texlive-full:2023.1
• ghcr.io/ayaka-notes/texlive-full:2022.1
• ghcr.io/ayaka-notes/texlive-full:2021.1
• ghcr.io/ayaka-notes/texlive-full:2020.1
• ghcr.io/ayaka-notes/texlive-full:base

Usamos el archivo espejo de texlive info, que incluye casi todas las versiones de texlive desde 1996 hasta 2025. Y, gracias al Dockerfile de Overleaf, podemos construir este proyecto más rápido.

¿Por qué no se admiten TeX Live 2019 y versiones anteriores?

Mantener estas imágenes antiguas es extremadamente difícil. Además, el sitio web texlive.info no ofrece información sobre las versiones de TeX Live publicadas antes de 2019, por lo que no podemos construir imágenes para esas versiones. Si necesitas una versión antigua concreta, abre un issue y háznoslo saber.

​

Componentes incluidos

La imagen Docker incluye los siguientes paquetes.

• Todos los paquetes de TeXLive (de ese año)
• Paquetes de R (solo una selección)
• fontconfig inkscape pandoc python3-pygments wget python3
• gnupg gnuplot perl-modules perl ca-certificates
• ghostscript qpdf r-base-core tar

La imagen Docker incluye las siguientes fuentes.

• Google Fonts
• Microsoft msttcorefonts
• Fuentes compatibles con Overleaf

Confirma si las fuentes correspondientes pueden usarse con fines comerciales. No nos hacemos responsables de ningún problema legal derivado de un uso incorrecto de las fuentes. Al descargar la imagen, aceptas esto automáticamente.

​

Licencia

MIT

​

Problemas

Problema 01: fallos de caché de fuentes

Cuando Overleaf compila un proyecto LaTeX y falta alguna fuente, es posible que la compilación tarde mucho tiempo, porque cuando falta una fuente, texlive intenta reconstruir toda la caché de fuentes. Es un proceso que lleva mucho tiempo.

En nuestra imagen hemos generado previamente la caché de fuentes; solucionamos este problema con este commit

Problema 02: SyncTeX extremadamente lento

Cuando uses esta imagen en sharelatex, es posible que SyncTeX sea extremadamente lento.

Consulta: https://github.com/overleaf/overleaf/issues/1150; basta con desactivar HTTP 2.0.

Problema 03: error al recompilar con la imagen oficial de TeX Live

Si usas la imagen oficial de texlive en Docker Hub, texlive/texlive, es posible que al recompilar un proyecto se produzca un error. En nuestra imagen, sin embargo, este problema está solucionado, porque usamos la imagen base de Ubuntu más reciente e instalamos todas las dependencias desde el repositorio oficial de Ubuntu.

​

Otros recordatorios técnicos

Al construir imágenes de texlive (anteriores a 2019), puede que tengas que prestar atención a los siguientes problemas:

• Antes de texlive 2017 solo se admiten http/ftp, por lo que no puedes usar https para descargar, a menos que modifiques el script peal.
• Antes de 2015 solo se proporciona el archivo sha256, por lo que no puedes usar sha512 para la comprobación.