OVERLEAF_SITE_URL | Where your instance of Overleaf is publicly available. This is used in public links, and when connecting over websockets, so must be configured correctly! |
OVERLEAF_ADMIN_EMAIL | The email address where users can reach the person who runs the site. |
OVERLEAF_APP_NAME | The name to display when talking about the running application. Defaults to ‘Overleaf (Community Edition)’. |
OVERLEAF_MONGO_URL and MONGO_URL | The URL of the Mongo database to use. |
OVERLEAF_REDIS_HOST and REDIS_HOST | The host name of the Redis instance to use. Both are required (see release notes). |
OVERLEAF_REDIS_PORT and REDIS_PORT | The port of the Redis instance to use. Both are required (see release notes). |
OVERLEAF_REDIS_PASS and REDIS_PASSWORD | The password to use when connecting to Redis (if applicable). Both environment variables need to be set. See enabling password authentication for more information. |
OVERLEAF_REDIS_TLS | If set to true, allows for the connection to a Redis instance requiring TLS.
Note: mTLS is currently not supported. |
OVERLEAF_NAV_TITLE | Set the tab title of the application. |
OVERLEAF_HEADER_IMAGE_URL_LIGHT and OVERLEAF_HEADER_IMAGE_URL_DARK | URLs of custom header logos for the light and dark themes (added in 6.3.0). Each theme falls back to OVERLEAF_HEADER_IMAGE_URL when its specific variable is unset. See Branding. |
OVERLEAF_LINKED_URL_OUTBOUND_PROXY | URL of an HTTP(S) proxy for fetching external linked files and external ZIP or TeX resources through the Open in Overleaf API. Available from the re-released Ayakaleaf Pro 6.3.0 (October 3, 2026). Leave unset to connect directly. Example: OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128. See Outbound Proxy for configuration and network access restrictions. |
OVERLEAF_INVITE_TOKEN_SECRET | Required. A random string used to secure project sharing tokens (Added in 6.2.0). Minimum characters: 16 |
OVERLEAF_SESSION_SECRET | Recommended. A random string used to sign the session cookies; if load balancing this needs to be set to the same token across boxes. If it is not set, a new random one is generated each time the container is created, so every bin/up that recreates the container (for example after changing config/variables.env) or an upgrade logs every user out. Generate it once with openssl rand -hex 32 and keep it. |
OVERLEAF_COOKIE_SESSION_LENGTH | Allows you to override the default session cookie expiration time of 5 days. The override value should be in milliseconds. Example: to make the session last 1 hour, set COOKIE_SESSION_LENGTH=3600000. |
OVERLEAF_TRUSTED_PROXY_IPS | If not set, defaults to loopback. If setting manually, in addition to your trusted IPs, you must also include loopback (or 127.0.0.1), which trusts the nginx instance running inside the sharelatex container. Only IP addresses and CIDR ranges are accepted: do not add hostnames such as localhost, otherwise Overleaf fails to start and returns 502 Bad Gateway.
If using a subnet from 172.16.0.0/12 (default subnet for Docker networks) for your regular network, please set OVERLEAF_TRUSTED_PROXY_IPS=loopback,<network> in your config/variables.env. Where <network> is the IPAM -> Config -> Subnet value in docker inspect overleaf_default, e.g. OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16. This is to prevent the spoofing of X-Forwarded headers.
If you are using an external TLS proxy (i.e. not managed by the Overleaf Toolkit), please ensure that OVERLEAF_TRUSTED_PROXY_IPS=loopback,<ip-of-your-tls-proxy>, e.g. OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37. |
OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS | If set to true, will restrict project invites to email addresses which correspond with existing user accounts. |
OVERLEAF_ALLOW_PUBLIC_ACCESS | If set to true, will allow non-authenticated users to view the site. The default is false, which means non-authenticated users will be unconditionally redirected to the login page when they try to view any part of the site. Note, setting this option does not disable authentication or security in any way. This option is necessary if your users intend to make their projects public and have non-authenticated users view those projects. |
OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING | If set to true, will allow anonymous users to view and edit projects shared via the link-sharing feature. |
OVERLEAF_DISABLE_LINK_SHARING | Disables the link-sharing feature. |
EMAIL_CONFIRMATION_DISABLED | When set to true the banner requesting email confirmation won’t be displayed. |
ADDITIONAL_TEXT_EXTENSIONS | An array of strings to configure additional extensions for editable files. |
DEFAULT_LATEX_COMPILER | Used to set the default compiler used by new projects. (Added in 6.2.0). Options: pdflatex, latex, xelatex or lualatex |
OVERLEAF_STATUS_PAGE_URL | Custom status page URL, e.g. status.example.com. |
OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS | Set to 'false' to prevent new projects from being initialised with Full Project History |
OVERLEAF_FPH_DISPLAY_NEW_PROJECTS | Set to 'false' to prevent new projects from displaying Full Project History instead of the legacy history |
ENABLE_CRON_RESOURCE_DELETION | Set this environment variable to true to enable the automatic clean-up of deleted projects and users after 90 days. |
OVERLEAF_USER_HARD_DELETION_DELAY | Used to modify the deleted users expiration delay. Configured in milliseconds.
Defaults: 90 days |
OVERLEAF_PROJECT_HARD_DELETION_DELAY | Used to modify the deleted projects expiration delay. Configured in milliseconds.
Defaults: 90 days |
MAX_UPLOAD_SIZE | Controls the maximum size of an individual upload, in megabytes. Defaults to 50.
Attention: This variable is just a raw number, without a unit(MB) or wrapper.
The total uncompressed size of an uploaded .zip file is limited to 6 × this value (300 MB by default). |
COMPILE_SIZE_LIMIT | Controls the maximum request body size in bytes. This is the sum of all doc file sizes within the project (main.tex, references.bib (if not linked) etc.), that needs to be sent in the initial compile request to the CLSI service. |
COMPILE_TIMEOUT | The amount of time in seconds allowed for a compile to complete. For more information see Updating project compile timeout. |
MAX_RECONNECT_GRACEFULLY_INTERVAL_MS | A configurable delay between editor graceful reconnection, data flushing, and container shutdown to mitigate the risk of data loss. |
SECCOMP_PROFILE | Set this environment variable to a path on the Docker host machine that points to the SECCOMP profile. You can download a copy of the profile here.
Currently needed for Podman deployments when using Sandboxed Compiles. |
OVERLEAF_DISABLE_CHAT | If set to true, disables the in-project chat feature. |
OVERLEAF_DISABLE_LOCAL_LOGIN | If set to true, hides the email and password login so users can only log in with LDAP, SAML or OIDC. Only takes effect when EXTERNAL_AUTH enables at least one of them (Added in Ayakaleaf Pro 6.3.1). |
OVERLEAF_LOGIN_SUPPORT_TEXT | When set, can be used to display support information underneath the login button. Text will be shown on the login screen and can be used to direct users to internal support or provide guidance related to logging in, creating accounts, etc. |
ALLOW_MONGO_ADMIN_CHECK_FAILURES | If set to true, allows the MongoDB start-up checks to fail and not prevent the deployment from starting. This may be required if you use a MongoDB database where your database user does not have the clusterParameterReader role.
For help on creating a custom role see here. |
V1_HISTORY_URL_FOR_GIT_BRIDGE | Allows separating the history-v1 endpoint for internal traffic (web service → history-v1 service, both in sharelatex container) and external traffic (git-bridge → history-v1, running in separate containers). |
OVERLEAF_MAINTENANCE_MESSAGE and OVERLEAF_MAINTENANCE_MESSAGE_HTML | Used to customize the title and content of the Maintenance page. Can’t be used with OVERLEAF_STATUS_PAGE_URL. |