Skip to main content
It’s possible to extend an existing TeX Live image using a new Dockerfile and configure the application to use the new image. Here are some guidelines to install new packages or fonts. The TeX Live images receive infrequent updates. We suggest rebuilding custom images when upgrading Ayakaleaf Pro.
The following sections apply to Sandboxed Compiles only.

Installing and updating new packages

You can use tlmgr commands such as tlmgr install and tlmgr update to manage Tex Live packages as in the following example:

Using tlmgr in an older TeX Live image

By default tlmgr downloads resources from the latest TeX Live release. When patching an older TeX Live image, the downloads need to be switched to the respective archive. See the list in https://www.tug.org/historic/ for mirrors of archives.

Installing new fonts

There are different procedures to install new fonts in a Tex Live distribution, and installing a custom font might require several steps. Checking the instructions to install TeX fonts in the official Tex Live documentation is probably a good starting point. The following Dockerfile shows an example of installing a TrueType font over an existing Tex Live 2022 image:

Configuring Ayakaleaf Pro to use the new images

Use the name ghcr.io/ayaka-notes/texlive-full and a custom tag to build the new image, as in:
We can now configure Ayakaleaf Pro to use the new 2023.1-custom image updating the TEX_LIVE_DOCKER_IMAGE, ALL_TEX_LIVE_DOCKER_IMAGES and ALL_TEX_LIVE_DOCKER_IMAGE_NAMES environment variables (the names are optional and follow the order of the images):
In the example above new projects are set by default to use the new 2023.1-custom image, while 2023.1 is still available for when it’s needed. The custom image exists only on your host, so bin/up cannot pull it. Set SIBLING_CONTAINERS_PULL=false in config/overleaf.rc (pull the other images yourself with docker pull), then run bin/up -d to apply the new settings.

Q&A

Answer: No, not with the texlive-full images. They include the TeX Live Chinese packages (ctex, xeCJK) with the Fandol fonts, and the Noto CJK fonts (for example Noto Serif CJK SC). Set the project’s compiler to XeLaTeX in the editor settings, then compile, for example:
To use Noto instead of Fandol, add \setCJKmainfont{Noto Serif CJK SC}. No latexmkrc is needed. For other fonts, build a custom image as shown in Installing new fonts.
Last modified on October 30, 2026