Skip to content

Issues

Jump to bottom
Heinrich Stamerjohanns edited this page Oct 31, 2021 · 8 revisions

Browser issues

  • When I queue files, my browser window is not updated.

    If you have restarted containers, please reload the page. Otherwise, please use a browser (e.g. Chrome, Firefox) that is capable to use SSE. Windows IE is not among these browsers.

Access issues

  • I cannot access the pages from other machines than the docker host.

    This is a feature. The system is supposed to be accessed only from localhost. Please do not change the default configuration and expose the system publicly without further access control, as others will then be able to upload files to your machine.

Docker issues

docker-composer fails to build

  • docker-compose up fails with something like 
    Step 8/15 : ADD bin/            /opt/latexml/bin
ERROR: Service 'latexml' failed to build: ADD failed: stat /var/lib/docker/tmp/docker-builder406273412/bin: 
no such file or directory
    The system includes LaTeXML as a submodule. You have not used the --recursive option, when you cloned the repository, therefore the submodule is missing. Please run git submodule update --init --recursive and start docker-compose up again.

Windows 10/11

  • On Windows you can either use wsl1 or wsl2. If you are using wsl2, you should install git in your guest linux system and install texmlbus inside there (the path is then /home/...), otherwise file access might be slow. If you use wsl2, do not install docker or docker-compose in your guest linux system, they will be automatically made available by Docker Desktop. Currently you will need to disable Docker Compose V2, though.

  • Avoid share drive questions

    Docker → Settings → Resources → File Sharing

    Add the folder texmlbus.

  • Unable to share drive On windows you will be asked to share a drive. Please click ”Share it”. Also the windows firewall might ask you to allow a connection.

    If you still receive error messages like unable to share drive, then a problem might be, that SMB is not enabled on your machine. To enable SMB2 on Windows 10, you need to press the Windows Key + S and start typing and click on Turn Windows features on or off. You can also search the same phrase in Start, Settings. Scroll down to SMB 1.0/CIFS File Sharing Support and check that top box.

  • Need more memory

    If you are not using wsl2 enabled Docker on Windows, you need to assign memory via

    Docker → Settings → Resources

    Increase Memory on the right side. It is worth it. If possible, switch to wsl2 on Windows.

  • docker compose v2 completely fails

    docker compose v2 fails to build images. I see a lot of errors.

    docker compose v2 has several regressions, that have not been solved yet. Please disable Docker Compose V2 in Settings->General in Docker-Desktop and restart docker and do wsl --shutdown.

Clone this wiki locally