Troubleshooting git bridge problems
The following troubleshooting tips aim to help fix the most common issues encountered when using the git bridge on Overleaf.
Contents
Repository not found errors
If you are seeing a Repository not found error, it's likely that the wrong URL is being used. The correct URL is listed under Git in the main project menu, and it is different from the git URL used for the same project on Overleaf v1, and the URL in the browser address bar.
It's also worth ensuring that git bridge is allowed on the project in question. This will be shown by opening the Git modal in the main project menu. Git bridge is a premium feature, so it will only be available if the project owner has a paid subscription to Overleaf, or has access to the feature for instance from beta testing.
Authentication failed errors
If you are seeing an Authentication failed error, you should make sure your account has an Overleaf password set. If you had registered your account through Google or ORCiD single sign-on, your Overleaf password should be set here, and this should be used when accessing the git bridge.
If there are any special characters (such as :
or &
) in your Overleaf password, these may also cause problems for the git authentication. It is recommended to change to a password without special characters, here.
It may also help to include your username in the URL by running e.g.
$ git clone https://<email>%40<domain>@git.overleaf.com/<id>
(where the %40
is necessary to escape the @
symbol).
Please note that it is no longer possible to use the git bridge without first logging into an account with permission to edit the project. This change from v1 was made to ensure that all edits can be traced.
Some operating systems will cache credentials as well, depending on the applications you have installed and their settings. (For example, Apple's Mac OS X Keychain will do this.) If you are experiencing unexplained authentication problems, this is another aspect to check.
Saving authentication credentials
Overleaf does not currently support SSH key authentication. To save time, one approach to enter your credentials less often is to run
$ git config --global credential.https://git.overleaf.com.username <e-mail address registered with Overleaf> $ git config --global credential.https://git.overleaf.com.helper cache
Still seeing problems?
Please write to our support team with details of what you are seeing.
Overleaf guides
- Creating a document in Overleaf
- Uploading a project
- Copying a project
- Creating a project from a template
- Using the Overleaf project menu
- Including images in Overleaf
- Exporting your work from Overleaf
- Working offline in Overleaf
- Using Track Changes in Overleaf
- Using bibliographies in Overleaf
- Sharing your work with others
- Using the History feature
- Debugging Compilation timeout errors
- How-to guides
LaTeX Basics
- Creating your first LaTeX document
- Choosing a LaTeX Compiler
- Paragraphs and new lines
- Bold, italics and underlining
- Lists
- Errors
Mathematics
- Mathematical expressions
- Subscripts and superscripts
- Brackets and Parentheses
- Matrices
- Fractions and Binomials
- Aligning Equations
- Operators
- Spacing in math mode
- Integrals, sums and limits
- Display style in math mode
- List of Greek letters and math symbols
- Mathematical fonts
Figures and tables
- Inserting Images
- Tables
- Positioning Images and Tables
- Lists of Tables and Figures
- Drawing Diagrams Directly in LaTeX
- TikZ package
References and Citations
- Bibliography management with bibtex
- Bibliography management with natbib
- Bibliography management with biblatex
- Bibtex bibliography styles
- Natbib bibliography styles
- Natbib citation styles
- Biblatex bibliography styles
- Biblatex citation styles
Languages
- Multilingual typesetting on Overleaf using polyglossia and fontspec
- Multilingual typesetting on Overleaf using babel and fontspec
- International language support
- Quotations and quotation marks
- Arabic
- Chinese
- French
- German
- Greek
- Italian
- Japanese
- Korean
- Portuguese
- Russian
- Spanish
Document structure
- Sections and chapters
- Table of contents
- Cross referencing sections and equations
- Indices
- Glossaries
- Nomenclatures
- Management in a large project
- Multi-file LaTeX projects
- Hyperlinks
Formatting
- Lengths in LaTeX
- Headers and footers
- Page numbering
- Paragraph formatting
- Line breaks and blank spaces
- Text alignment
- Page size and margins
- Single sided and double sided documents
- Multiple columns
- Counters
- Code listing
- Code Highlighting with minted
- Using colours in LaTeX
- Footnotes
- Margin notes
Fonts
Presentations
Commands
Field specific
- Theorems and proofs
- Chemistry formulae
- Feynman diagrams
- Molecular orbital diagrams
- Chess notation
- Knitting patterns
- CircuiTikz package
- Pgfplots package
- Typing exams in LaTeX
- Knitr
- Attribute Value Matrices
Class files
- Understanding packages and class files
- List of packages and class files
- Writing your own package
- Writing your own class
- Tips