Bridge hack between Overleaf CE and Git [my fork from]
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Axel Kittenberger 25d2093b7b Merge branch 'docker' into 'main' 12 months ago
lib init 1 year ago
src retrying join events 1 year ago
.eslintrc.js init 1 year ago
.gitignore init 1 year ago
Dockerfile Make Dockerfile more generic for this repo 12 months ago
LICENSE copyright 1 year ago Add more explanations to README 12 months ago
config.js init 1 year ago
eslint init 1 year ago
package-lock.json init 1 year ago
package.json init 1 year ago
run-bridge init 1 year ago


Another Overleaf git bridge. This hack allows you to pull and push changes via git on an Overleaf Community Edition (CE) or Pro server, like shown in the official Overleaf SaaS announcement. Just use git clone http://your.server.invalid/<project-id>, where your project ID can be seen from your Overleaf instance.

This gitbridge uses the web API of Overleaf to down- and upsync changes. This means it does not need to run on the same server as Overleaf. In fact it is recommended to run it on another so it can directly use https port 443.

Note that contrary to the cloud version this bridge does not use realtime change operations, any files changed by git will result in a "this file has been changed externally" interruption in the online editor.

Getting started

Start installing (likely on another server than the Overleaf server)

git clone
cd olgitbridge
npm install

edit config.js in your favorite editor.

If the bridge is running on port 80 and or 443 using authbind may be a good idea.

Start the server with (or without authbind)

authbind node src/server.js

Wrap it in your auto(re)starter/service of your choice.

Docker container

There is a Dockerfile provided here, feel free to use it for your deployment. Make sure to edit the config before launching the service. It might make sense to mount the /var/olgitbridge/... folders, so the content persists a software update. I recommend configuring the basedir before building the container to /var/olgitbridge/data.

The container exposes port 5000 by default.


In development node.js v16.11.0 was used.