This image allows you to run MiKTeX on any computer that supports Docker.
This image is forked from https://github.com/MiKTeX/docker-miktex, with Chinese fonts and Makefile tools preinstalled.
Get the latest image from the registry:
docker pull nanmu42/miktex-docker
The host directory containing the input files must be mounted to the
container path /miktex/work
.
To mount the current host working directory, you would pass option -v $(pwd):/miktex/work
to the Docker run
command.
The container image contains a bare MiKTeX setup and MiKTeX is
configured to install missing package files in the container directory
/miktex/.miktex
. It is recommended that you mount this directory to
a dedicated Docker volume.
By default, all commands inside the container are executed as root
.
It is possible to execute as a dedicated host user by
setting the container environment variables MIKTEX_GID
and MIKTEX_UID
.
To execute as the current user, you would pass options -e MIKTEX_GID=$(id -g)
and -e MIKTEX_UID=$(id -u)
to the Docker run
command.
First, create a Docker volume named miktex
:
docker volume create --name miktex
This volume will be used to mount the the container directory
/miktex/.miktex
in subsequent runs.
Provided that your main input file is located in the current working
directory, you can run pdflatex
as follows:
docker run --rm -ti \
-v miktex:/miktex/.miktex \
-v $(pwd):/miktex/work \
-e MIKTEX_GID=$(id -g) \
-e MIKTEX_UID=$(id -u) \
nanmu42/miktex-docker \
pdflatex main.tex