You cannot 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 0c9717e716 fixing upsyncing deep dir structures 2 years ago
lib init 2 years ago
src fixing upsyncing deep dir structures 2 years ago
.eslintrc.js init 2 years ago
.gitignore init 2 years ago
Dockerfile Make Dockerfile more generic for this repo 2 years ago
LICENSE copyright 2 years ago Add more explanations to README 2 years ago
config.js init 2 years ago
eslint init 2 years ago
package-lock.json init 2 years ago
package.json init 2 years ago
run-bridge init 2 years 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.