Docker FAQ

tlmgr: local version is older than remote repository

# sudo tlmgr update --self --all

tlmgr: Local TeX Live (2021) is older than remote repository (2022).
Cross release updates are only supported with
  update-tlmgr-latest(.sh/.exe) --update
See for details.

If you receive an error like this when using tlmgr, it means that it is trying to use a more recent version. It can easily be fixed by running the following command (for example in postCreateCommand or in a pipeline):

# sudo tlmgr option repository


The year in the url must match the version shown in the error message.

sudo: command not found

Older versions of our docker image did not yet have sudo installed. They thus are not capable of installing new packages in a running container.

You can learn how to extend the image anyway in the instructions here.

Docker image cannot be pulled

Are you logged in to the docker registry on GitLab?

Add additional LaTeX packages to the VSCode Docker image

Please read here