https://github.com/ayaka-notes/texlive-full
🐳 TeXLive-Full in Docker (Specially For Overleaf CEP/Pro)
https://github.com/ayaka-notes/texlive-full
docker docker-image latex overleaf overleaf-pro texlive
Last synced: 4 months ago
JSON representation
🐳 TeXLive-Full in Docker (Specially For Overleaf CEP/Pro)
- Host: GitHub
- URL: https://github.com/ayaka-notes/texlive-full
- Owner: ayaka-notes
- License: mit
- Created: 2024-02-15T06:12:09.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-02-17T08:56:28.000Z (4 months ago)
- Last Synced: 2026-02-17T13:49:55.203Z (4 months ago)
- Topics: docker, docker-image, latex, overleaf, overleaf-pro, texlive
- Language: Dockerfile
- Homepage: https://github.com/ayaka-notes/texlive-full
- Size: 25.7 MB
- Stars: 14
- Watchers: 0
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TeXLive-Full Edition
A fully-featured **TeXLive Docker image** designed for Overleaf Server Pro, Overleaf-CEP, and 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.
## ✨ Features
- 📦 Nearly full TeXLive installation
- 🧩 Preinstalled common fonts and utilities
- 🐳 Ready to use with Docker and Docker Compose
- 🧪 Tested with Overleaf Server Pro / Overleaf-CEP
- 🏷 Multiple version tags (2020 – Latest)
> [!WARNING]
> - This Docker Image **doesn't contain** any sharelatex/overleaf component. It's used for Overleaf/Overleaf Pro's compile.
> - If you want to use Sharelatex CE with inner contained LaTeX compile, refer to [Overleaf official](github.com/overleaf/overleaf) to find more tutorials. This repository is for server-pro's Docker Compile.
## Release Notes
- (2026.2.1): We add a `tex` user to align with Overleaf's default compile image.
- (2026.1.21): Knitr has been added into the image, which can support R code compile in LaTeX document. To find out more, visit [Using R with LaTeX on Overleaf](https://docs.overleaf.com/integrations-and-add-ons/r-code-knitr)
- (2024.4.17): A long time compile bug [link #1](https://github.com/ayaka-notes/texlive-full/issues/1) has been fixed now
- (2024.4.17): Texlive 2025 image has been added
## 🎯 Overleaf-CEP Usage
Texlive-full@Ayaka-notes support [overleaf-cep](https://github.com/yu-i-i/overleaf-cep), you can use the following environment variables to `config/variables.env` file if you are [toolkit user](https://github.com/overleaf/toolkit).
For example:
```
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
```
If you need more help, refer to [overleaf-cep documentation](https://github.com/yu-i-i/overleaf-cep/wiki/Extended-CE:-Sandboxed-Compiles)
## 📦 Available TeXLive Version
Thanks to Github Action, we can build all tex image parallel, which includes:
- `ghcr.io/ayaka-notes/texlive-full:2025.1` (Also `latest` tag)
- `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`
We use mirror archive from [utah university](https://ftp.math.utah.edu/pub/tex/historic/systems/texlive/), which includes almost all texlive image ranging from 1996 to 2024. And thankes to Overleaf's Dockerfile, we can build this project faster.
> Why texlive 2019 and earlier are not supported ?
>
> To maintain such images is more than difficult. And we believe you may not use it any more since it's too old. If you need, open a issue to let me know.
> [!TIP]
> For China mainland users, you can replace `ghcr.io` with `ghcr.nju.edu.cn` to speed up the download.
## Contained Component
The following packages are contained in the docker image.
- fontconfig inkscape pandoc python3-pygments wget python3
- gnupg gnuplot perl-modules perl ca-certificates git
- ghostscript qpdf r-base-core tar
The following fonts are contained in the docker image.
- [Google Fonts](https://fonts.google.com/)
- [Microsoft msttcorefonts](https://packages.ubuntu.com/jammy/ttf-mscorefonts-installer)
- [Overleaf supported fonts](https://www.overleaf.com/learn/latex/Questions/Which_OTF_or_TTF_fonts_are_supported_via_fontspec%3F)
> [!WARNING]
> Please confirm whether the relevant fonts can be used commercially. We are **not responsible** for any legal issues arising from your incorrect use of fonts. Once you download image, You agree with this automatically.
## License
MIT
## Known Issues and Solutions
### 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](https://github.com/ayaka-notes/texlive-full/commit/0cb66b0dc8b82be628cf6999cfd659d9784e132f)
### 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
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.
### Problem 04: Minted Package Error
If you use `minted` package in your latex project, you may find that a permission error preventing access to minted config file. Please see [#131](https://github.com/yu-i-i/overleaf-cep/issues/131) for more details.
## Other Tech Reminder
While build texlive image(before 2019), you may need to pay attention to the following problems:
- Only `http`/`ftp` is supported before texlive 2017, so you can't use `https` to download, unless you modify the `peal` script.
- Before 2015, only sha256 file is provided. So you can't use sha512 to check.