Zotero Integration

This feature is initially developed by davrot and yu-i-i/overleaf-cep, modified by ayaka-notes/ayakaleaf-pro with OAuth. It is introduced from v6.2.0 and later. It’s still in beta status. We need your feedback if you have any problem.

Setup Zotero Integration

1. Open this link to create a Zotero OAuth client (as image shows)
2. Choose Application Type: Browser
3. Setup Callback URL with your ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
4. Configure your config/variables.env

config/variables.env

#################
#    Zotero     #
#################
# 'zotero' must be in ENABLED_LINKED_FILE_TYPES (set in develop/docker-compose.yml)
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url,zotero

# From a Zotero OAuth client (register at https://www.zotero.org/oauth/apps)
# Application Type: Browser 
# Callback URL -> ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
ZOTERO_CLIENT_ID=
ZOTERO_CLIENT_SECRET=
# Encrypts the Zotero API key in mongo (set in dev to avoid writing a key file
# to /var/lib/overleaf/data, which the dev web container can't create)
# How to generate: `openssl rand -hex 32`
ZOTERO_CIPHER_PASSWORD=dev-zotero-cipher-password
# Optional: route the module's server-side Zotero requests (OAuth + API) through
# an HTTP proxy (must be reachable from the web container; same as github-sync)
# http://10.0.0.1:10808
# (Optional) ZOTERO_PROXY_URL=

Notes

When upgrading an existing installation with Zotero linked bibliography files to the re-released 6.3.0, follow the Zotero / Mendeley migration instructions. New installations do not need this migration.

Since Ayakaleaf is a collaborative platform, to improve security, starting with version 6.3.0, only the original creator of a Reference bib file will be allowed to update the imported file.

For example, suppose the project owner, User A, enables link sharing and creates a test.bib file in the project, linking it to their own Zotero account. If another user, User B, accesses the project through the shared link, User B will still be able to read and download test.bib, but will not be allowed to update or re-import the file from Zotero. Only User A, as the original creator of the Reference file, can perform updates. Conversely, only the original creator of the .bib file has permission to update it.