> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/texlive/es/texlive-en-docker.md).
# TeXLive en Docker
### Docker
Docker ofrece una forma ligera y portátil de empaquetar y ejecutar aplicaciones en contenedores aislados. Al agrupar la aplicación junto con todas las dependencias necesarias, un contenedor garantiza un comportamiento consistente en diferentes máquinas, desde portátiles hasta servidores de producción.
TeX Live es potente, pero grande y sensible a diferencias a nivel de sistema. Empaquetar TeX Live dentro de una imagen de 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 razones de seguridad, el contenedor debe ejecutarse en un entorno restringido que impida a los usuarios ejecutar comandos arbitrarios de shell (por ejemplo mediante `\write18` o shell escape). Este aislamiento protege el sistema anfitrión y evita el acceso no intencionado al sistema de archivos subyacente del contenedor o a herramientas como `bash`.
### TeXLive Edición Completa
[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) es una **imagen Docker de TeXLive** diseñada especialmente para Overleaf Server Pro, Overleaf Pro y también para entornos independientes de compilación LaTeX, como CI o pipelines.
Esta imagen tiene como objetivo 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.
Características:
* 🚀 Compatibilidad con arquitecturas de servidor x86\_64 y arm64
* 📦 Instalación completa y optimizada de TeXLive
* 🧩 Fuentes y utilidades comunes preinstaladas
* 🐳 Listo para usar con Docker y Docker Compose
* 🧪 Probado con Overleaf Server Pro / Overleaf Pro
* 🔄 Actualizado regularmente con las últimas versiones de TeXLive
* 🏷 Varias etiquetas de versión de TeXLive (2020 – Última)
* 🧑🔬 Compatibilidad con Knitr para código R en documentos LaTeX
### Uso de Overleaf Pro
[TeXLive-Full@ayaka-notes](https://github.com/ayaka-notes/texlive-full/) soporte **overleaf pro**, puedes usar las siguientes variables de entorno para `config/variables.env` archivo si eres [usuario de toolkit](https://github.com/overleaf/toolkit).
Por ejemplo:
{% code title="config/variables.env" overflow="wrap" %}
```dotenv
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2025.1, ghcr.io/ayaka-notes/texlive-full:2024.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2025, Texlive 2024
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2025.1
```
{% endcode %}
### Versión de TeXLive
Gracias a GitHub Actions, podemos construir todas las imágenes tex en paralelo, lo que incluye:
* `ghcr.io/ayaka-notes/texlive-full:2026.1` (también `latest` etiqueta)
* `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 [información de texlive](https://texlive.info/tlnet-archive/), que incluye casi todas las imágenes de texlive desde 1996 hasta 2026. Y gracias al Dockerfile de Overleaf, podemos construir este proyecto más rápido.
> ¿Por qué no se admiten texlive 2019 y anteriores?
>
> Mantener esas imágenes es más que difícil. Y creemos que quizá ya no las uses, ya que son demasiado antiguas. Si lo necesitas, abre un issue para avisarme.
### Componente incluido
Los siguientes paquetes están incluidos en la imagen de Docker.
* Todos los paquetes de TeXLive (de ese año)
* Paquetes de R (solo seleccionados)
* fontconfig inkscape pandoc python3-pygments wget python3
* gnupg gnuplot perl-modules perl ca-certificates
* ghostscript qpdf r-base-core tar
Las siguientes fuentes están incluidas en la imagen de Docker.
* [Google Fonts](https://fonts.google.com/)
* [Microsoft msttcorefonts](https://packages.ubuntu.com/jammy/ttf-mscorefonts-installer)
* [Fuentes compatibles con Overleaf](https://www.overleaf.com/learn/latex/Questions/Which_OTF_or_TTF_fonts_are_supported_via_fontspec%3F)
{% hint style="warning" %}
Por favor, confirma si las fuentes relevantes pueden usarse comercialmente. No somos **responsables** de cualquier problema legal derivado de tu uso incorrecto de las fuentes. Una vez que descargues la imagen, aceptas esto automáticamente.
{% endhint %}
### Licencia
MIT
### Problemas
Problema 01: Problema de falta de caché de fuentes
Cuando Overleaf compila un proyecto LaTeX, si se produce una falta de fuente, **puede que veas que el proceso de compilación tarda mucho tiempo**, eso se debe a que cuando falta una fuente, TeXLive intentará **reconstruir toda la caché de fuentes**. Este es un proceso que consume tiempo.
En nuestra imagen, hemos precalculado la caché de fuentes; solucionamos este problema mediante [este commit](https://github.com/ayaka-notes/texlive-full/commit/0cb66b0dc8b82be628cf6999cfd659d9784e132f)
Problema 02: SyncTeX extremadamente lento
Cuando uses esta imagen en ShareLaTeX, puede que notes que SyncTeX es extremadamente lento.
Consulta: , simplemente desactiva HTTP 2.0.
Problema 03: Error de recompilación con la imagen oficial de TeXLive
Si usas la imagen oficial de TeXLive en Docker Hub `texlive/texlive`, puede que veas que al recompilar un proyecto, se reporta un error. Sin embargo, en nuestra imagen, este problema está resuelto. Porque usamos la última imagen base de Ubuntu e instalamos todas las dependencias desde el repositorio oficial de Ubuntu.
### Otros recordatorios técnicos
Al construir la imagen de TeXLive (antes de 2019), puede que necesites prestar atención a los siguientes problemas:
* Solo `http`/`ftp` se admite antes de TeXLive 2017, así que no puedes usar `https` para descargar, a menos que modifiques el `peal` script.
* Antes de 2015, solo se proporciona el archivo sha256. Así que no puedes usar sha512 para comprobar.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://overleaf-pro.ayaka.space/texlive/es/texlive-en-docker.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.