Docker
Docker provides a lightweight and portable way to package and run applications in isolated containers. By bundling the application together with all required dependencies, a container ensures consistent behavior across different machines, from laptops to production servers. TeX Live is powerful but large and sensitive to system-level differences. Packaging TeX Live inside a Docker image makes the LaTeX toolchain predictable, reproducible, and easy to distribute. However, some TeX Live packages rely on shell access. For security reasons, the container should run in a restricted environment that prevents users from executing arbitrary shell commands (for example via\write18 or shell escape). This isolation protects the host system and avoids unintended access to the container’s underlying filesystem or tools such as bash.
TeXLive Full Edition
TeXLive-Full@ayaka-notes is a fully-featured TeXLive Docker image designed for sandboxed LaTeX compilation in Ayakaleaf Pro, Overleaf CEP, or standalone LaTeX compilation environments. This image aims to provide an almost complete TeXLive distribution with common fonts and tools preinstalled, in order to minimize compilation failures caused by missing packages or fonts. Notes: This Docker Image doesn’t contain any sharelatex/overleaf component. It’s used for Overleaf/Overleaf Pro’s compile.Features:
- 🚀 Support Both x86_64 and arm64 server architectures
- 📦 Full and Optimized TeXLive installation
- 🧩 Preinstalled common fonts and utilities
- 🐳 Ready to use with Docker and Docker Compose
- 🧪 Tested with Overleaf Server Pro / Overleaf Pro
- 🔄 Regularly Updated with Latest TeXLive Releases
- 🏷 Multiple TeXLive Version tags (2020 – Latest)
- 🧑🔬 Knitr support for R code in LaTeX documents
Ayakaleaf Pro Usage
TeX Live Full by Ayaka-notes is specially designed for ayakaleaf-pro, you can use the following environment variables toconfig/variables.env file if you are toolkit user.
For example:
config/variables.env
TeX Live Version
Thanks to Github Action, we can build all tex image parallel, which includes:ghcr.io/ayaka-notes/texlive-full:2026.1(Alsolatesttag)ghcr.io/ayaka-notes/texlive-full:2025.1ghcr.io/ayaka-notes/texlive-full:2024.1ghcr.io/ayaka-notes/texlive-full:2023.1ghcr.io/ayaka-notes/texlive-full:2022.1ghcr.io/ayaka-notes/texlive-full:2021.1ghcr.io/ayaka-notes/texlive-full:2020.1ghcr.io/ayaka-notes/texlive-full:base
Why TeX Live 2019 and earlier are not supported ? Maintaining these old images is extremely difficult. Also, the texlive.info website does not provide information for TeX Live versions released before 2019, so we are unable to build images for those versions. If you need a specific old version, please open an issue and let us know.
Contained Component
The following packages are contained in the docker image.- All TeXLive packages(in that year)
- R packages(only selected)
- fontconfig inkscape pandoc python3-pygments wget python3
- gnupg gnuplot perl-modules perl ca-certificates
- ghostscript qpdf r-base-core tar
License
MITProblems
Problem 01: Font Cache Miss Problem
Problem 01: Font Cache Miss Problem
When overleaf compile latex project, if font miss occurs, you may find the compile progress takes a long time, that is because when a font is miss, texlive will try to rebuild the whole font cache. This is a time-consuming process.In our image, we have pre-built the font cache, we fix this problem by this commit
Problem 02: Sync Tex Extremely Slow
Problem 02: Sync Tex Extremely Slow
When you use this image in sharelatex, you may find that the sync tex is extremely slow.See: https://github.com/overleaf/overleaf/issues/1150, just disable http 2.0.
Problem 03: Re-Compile Error with Official Texlive Image
Problem 03: Re-Compile Error with Official Texlive Image
If you use texlive official image on docker hub
texlive/texlive, you may find that when you re-compile a project, it will report error. However, in our image, this problem is fixed. Becase we use latest ubuntu base image and install all dependencies from ubuntu official repo.Other Tech Reminder
While build texlive image(before 2019), you may need to pay attention to the following problems:- Only
http/ftpis supported before texlive 2017, so you can’t usehttpsto download, unless you modify thepealscript. - Before 2015, only sha256 file is provided. So you can’t use sha512 to check.