Variáveis de ambiente

Esta página descreve as variáveis de ambiente suportadas no arquivo config/variables.env em implantações com o Toolkit.

O arquivo config/variables.env consiste em definições de variáveis no formato NAME=value; linhas que começam com # são tratadas como comentários.

É necessário recriar os contêineres Docker após alterar qualquer coisa em overleaf.rc ou variables.env, executando bin/up.

​

Todas as versões

Estas variáveis de ambiente são compatíveis com o Server CE e o Server Pro e oferecem um caminho de migração simples entre essas duas versões on-premises. Elas também podem ser usadas tanto em implantações com o Toolkit quanto com Docker Compose.

Anteriormente, estas variáveis de ambiente tinham o prefixo SHARELATEX_ em vez de OVERLEAF_.

Nome	Descrição
OVERLEAF_SITE_URL	Onde a sua instância do Overleaf está disponível publicamente. Isso é usado em links públicos e nas conexões via websockets, portanto deve ser configurado corretamente!
OVERLEAF_ADMIN_EMAIL	O endereço de e-mail pelo qual os usuários podem entrar em contato com a pessoa que administra o site.
OVERLEAF_APP_NAME	O nome a ser exibido ao se referir à aplicação em execução. O padrão é ‘Overleaf (Community Edition)’.
OVERLEAF_MONGO_URL e MONGO_URL	A URL do banco de dados Mongo a ser usado.
OVERLEAF_REDIS_HOST e REDIS_HOST	O nome do host da instância do Redis a ser usada. Ambas são obrigatórias (consulte as notas de versão).
OVERLEAF_REDIS_PORT e REDIS_PORT	A porta da instância do Redis a ser usada. Ambas são obrigatórias (consulte as notas de versão).
OVERLEAF_REDIS_PASS e REDIS_PASSWORD	A senha a ser usada ao conectar ao Redis (se aplicável). Ambas as variáveis de ambiente precisam ser definidas. Consulte ativando a autenticação por senha para mais informações.
OVERLEAF_REDIS_TLS	Se definida como true, permite a conexão a uma instância do Redis que exige TLS. Observação: o mTLS não é suportado atualmente.
OVERLEAF_NAV_TITLE	Define o título da aba da aplicação.
OVERLEAF_HEADER_IMAGE_URL_LIGHT e OVERLEAF_HEADER_IMAGE_URL_DARK	URLs de logotipos personalizados do cabeçalho para os temas claro e escuro (adicionadas na 6.3.0). Cada tema recorre a OVERLEAF_HEADER_IMAGE_URL quando sua variável específica não está definida. Consulte Branding.
OVERLEAF_LINKED_URL_OUTBOUND_PROXY	URL de um proxy HTTP(S) para buscar arquivos vinculados externos e recursos ZIP ou TeX externos por meio da API Open in Overleaf. Disponível a partir do relançamento do Ayakaleaf Pro 6.3.0 (3 de outubro de 2026). Deixe sem definir para conectar diretamente. Exemplo: OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128. Consulte Outbound Proxy para a configuração e as restrições de acesso à rede.
OVERLEAF_INVITE_TOKEN_SECRET	Obrigatória. Uma string aleatória usada para proteger os tokens de compartilhamento de projetos (adicionada no Server Pro 6.2.0). Mínimo de caracteres: 16
OVERLEAF_SESSION_SECRET	Uma string aleatória usada para proteger tokens; em caso de balanceamento de carga, ela precisa ser definida com o mesmo token em todas as máquinas. Se apenas 1 instância estiver em execução, o usuário não precisa defini-la.
OVERLEAF_COOKIE_SESSION_LENGTH	Permite substituir o tempo de expiração padrão de 5 dias do cookie de sessão. O valor deve ser informado em milissegundos. Exemplo: para que a sessão dure 1 hora, defina COOKIE_SESSION_LENGTH=3600000. (Adicionada no Server Pro 4.2)
OVERLEAF_TRUSTED_PROXY_IPS	Se não for definida, o padrão é loopback. Ao defini-la manualmente, além dos seus IPs confiáveis, você também deve incluir loopback (ou 127.0.0.1), que confia na instância do nginx em execução dentro do contêiner sharelatex. Apenas endereços IP e intervalos CIDR são aceitos: não adicione nomes de host como localhost; caso contrário, o Overleaf não iniciará e retornará 502 Bad Gateway. Se você usar uma sub-rede de 172.16.0.0/12 (sub-rede padrão das redes Docker) na sua rede normal, defina OVERLEAF_TRUSTED_PROXY_IPS=loopback,<network> no seu config/variables.env, em que <network> é o valor IPAM -> Config -> Subnet em docker inspect overleaf_default, por exemplo, OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16. Isso serve para evitar a falsificação de cabeçalhos X-Forwarded. Se você estiver usando um proxy TLS externo (ou seja, não gerenciado pelo Overleaf Toolkit), certifique-se de que OVERLEAF_TRUSTED_PROXY_IPS=loopback,<ip-of-your-tls-proxy>, por exemplo, OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37.
OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS	Se definida como true, restringe os convites para projetos a endereços de e-mail que correspondam a contas de usuário existentes.
OVERLEAF_ALLOW_PUBLIC_ACCESS	Se definida como true, permite que usuários não autenticados visualizem o site. O padrão é false, o que significa que usuários não autenticados serão redirecionados incondicionalmente para a página de login ao tentar visualizar qualquer parte do site. Observe que definir esta opção não desativa a autenticação nem a segurança de forma alguma. Esta opção é necessária se os seus usuários pretendem tornar seus projetos públicos e permitir que usuários não autenticados os visualizem.
OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING	Se definida como true, permite que usuários anônimos visualizem e editem projetos compartilhados por meio do recurso de compartilhamento por link.
OVERLEAF_DISABLE_LINK_SHARING	Desativa o recurso de compartilhamento por link.
EMAIL_CONFIRMATION_DISABLED	Quando definida como true, o banner solicitando a confirmação do e-mail não será exibido.
ADDITIONAL_TEXT_EXTENSIONS	Um array de strings para configurar extensões adicionais de arquivos editáveis.
DEFAULT_LATEX_COMPILER	Usada para definir o compilador padrão usado por projetos novos. (Adicionada no Server Pro 6.2.0). Opções: pdflatex, latex, xelatex ou lualatex
OVERLEAF_STATUS_PAGE_URL	URL personalizada da página de status (adicionada no Server Pro 3.4.0), por exemplo, status.example.com.
OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS	Defina como 'false' para impedir que novos projetos sejam inicializados com o Full Project History (adicionada no Server Pro 3.5.0).
OVERLEAF_FPH_DISPLAY_NEW_PROJECTS	Defina como 'false' para impedir que novos projetos exibam o Full Project History em vez do histórico legado (adicionada no Server Pro 3.5.0).
ENABLE_CRON_RESOURCE_DELETION	Defina esta variável de ambiente como true para ativar a limpeza automática de projetos e usuários excluídos após 90 dias.
OVERLEAF_USER_HARD_DELETION_DELAY	Usada para modificar o prazo de expiração de usuários excluídos. Configurada em milissegundos. Padrão: 90 dias
OVERLEAF_PROJECT_HARD_DELETION_DELAY	Usada para modificar o prazo de expiração de projetos excluídos. Configurada em milissegundos. Padrão: 90 dias
MAX_UPLOAD_SIZE	Controla o tamanho máximo de um upload individual, em megabytes. O padrão é 50. Atenção: esta variável é apenas um número, sem unidade (MB) nem delimitadores. O tamanho total descompactado de um arquivo .zip enviado é limitado a 6 × este valor (300 MB por padrão).
COMPILE_SIZE_LIMIT	Controla o tamanho máximo do corpo da requisição, em bytes. É a soma dos tamanhos de todos os arquivos de documento do projeto (main.tex, references.bib (se não estiver vinculado) etc.) que precisam ser enviados na requisição inicial de compilação ao serviço CLSI.
COMPILE_TIMEOUT	O tempo, em segundos, permitido para que uma compilação seja concluída. Para mais informações, consulte Atualizando o tempo limite de compilação do projeto.
MAX_RECONNECT_GRACEFULLY_INTERVAL_MS	Um atraso configurável entre a reconexão controlada do editor, a gravação dos dados e o desligamento do contêiner, para reduzir o risco de perda de dados.
SECCOMP_PROFILE	Defina esta variável de ambiente com um caminho na máquina host do Docker que aponte para o perfil SECCOMP. Você pode baixar uma cópia do perfil aqui. Atualmente necessária para implantações com Podman ao usar Sandboxed Compiles.
OVERLEAF_DISABLE_CHAT	Se definida como true, desativa o recurso de chat dentro do projeto.
OVERLEAF_LOGIN_SUPPORT_TEXT	Quando definida, pode ser usada para exibir informações de suporte abaixo do botão de login. O texto será exibido na tela de login e pode ser usado para direcionar os usuários ao suporte interno ou fornecer orientações sobre login, criação de contas etc.
ALLOW_MONGO_ADMIN_CHECK_FAILURES	Se definida como true, permite que as verificações de inicialização do MongoDB falhem sem impedir que a implantação seja iniciada. Isso pode ser necessário se você usar um banco de dados MongoDB em que o usuário do banco não tenha a função clusterParameterReader. Para obter ajuda sobre como criar uma função personalizada, consulte aqui.
V1_HISTORY_URL_FOR_GIT_BRIDGE	Permite separar o endpoint do history-v1 para o tráfego interno (serviço web → serviço history-v1, ambos no contêiner sharelatex) e o tráfego externo (git-bridge → history-v1, executados em contêineres separados).
OVERLEAF_MAINTENANCE_MESSAGE e OVERLEAF_MAINTENANCE_MESSAGE_HTML	Usadas para personalizar o título e o conteúdo da página de manutenção. Não podem ser usadas com OVERLEAF_STATUS_PAGE_URL.

É possível impor restrições de senha aos usuários ao usar o sistema de login do Overleaf (contas locais), e não uma opção de SSO como o LDAP. Para contas SSO, as políticas de senha serão aplicadas pelo seu provedor de identidade ou serviço de diretório, o que também permite o suporte à autenticação multifator.