Docker Sharelatex-full

ShareLatex with all Latex packages installed by default.

What is

This is an extension of the official sharelatex.

The goal is to create an image with many Latex packages as possible, so you do not have (hopefully) to worry about missing packages. The downside is the large size of the image.

The tlmgr full scheme is installed on top of Sharelatex, plus additional external tools required by common LaTeX packges:

• latexminted for Code Highlighting with minted

And with shell-escape enabled:

• Inkscape to support SVG images
• Graphviz using dot2tex package
• Asymptote using asypictureB package
• gnuplot using gnuplottex package

Warning

Be aware that using -shell-escape or -enable-write18 allows LATEX to run potentially arbitrary commands on your system. These should only be used when necessary, with documents from trusted sources. If you understand the implications use the docker image rigon/sharelatex:latest-shell-escape instead.

How to run

Using the provided docker-compose.yml file, you should only need to run:

docker compose up

Then open the page to start using:

• http://localhost:8080/launchpad

How to build

To avoid cloning multiple times the TeX Live repositories, you can Downloading/mirroring the TeX Live repository locally:

wget -c --mirror --no-parent ftp://tug.org/historic/systems/texlive/2023/tlnet-final/

Or you can Acquiring TeX Live as an ISO image and extract it in the current directory.

Then, build the image with local repository. You have to dit Dockerfile to use local instance of nginx:

docker network create build_sharelatex
docker run --network build_sharelatex --name nginx -v ${PWD}:/usr/share/nginx/html:ro -d nginx
docker build --network build_sharelatex -t sharelatex-full .

Troubleshooting

The default for the overlay config metacopy was switched from N to Y in kernel 4.19. The following should do the trick to get you going:

echo N | sudo tee /sys/module/overlay/parameters/metacopy

How to use

This image can be used in the same way as the official image.

Since Sharelatex requires MongoDB and Redis, it is easier to setup via docker-compose.yml (just the sharelatex image needs to be changed to rigon/sharelatex-full).

Contribute

Contributions to this project are very welcome, by reporting issues or just by sharing your support. That means the world to me!

Please help me maintaining this project, only with your support I can take the time to make it even better. Look here for more info https://www.rigon.uk/#contribute