Troubleshooting

Here are some possible causes for errors in the logs.

CLSI

Log location in the container: /var/log/sharelatex/clsi.log

(HTTP code 400) unexpected - OCI runtime create failed

...opt/synctex ... not a directory

Full message reads roughly (after removing quite a lot of noise): <path> is not a directory; Are you trying to mount a directory onto a file (or vice-versa)? Check if the specified host path exists and is the expected type

Check the value of the SYNCTEX_BIN_HOST_PATH environment variable --- please see this documentation.

Recovering deleted docs

Docs are logically deleted and will be in the deletedDocs array in the project document.

List the deleted docs in mongo:

db.projects.findOne({_id: ObjectId("<project_id>")}, { deletedDocs: 1} )

Then open a shell in the sharelatex container. From there you can run the restore_soft_deleted_docs script.

You will need:

• your admin user ID
• the project ID
• the list of doc names from deletedDocs

Example restoring a deleted restoreMe.tex document:

node /var/www/sharelatex/web/scripts/restore_soft_deleted_docs.js <admin_id> <project_id> restoreMe.tex
{ doc:
   { _id: 5f91b367e86f6d0001680ecc,
     name: '2020-10-22T16-29-27.066Z-restoreMe.tex' },
  folderId: null }

This will have created a bunch of docs in the root of the project that look like TIMESTAMP-original-name. They should have the content and the tracked changes and comments from before deletion.