> ## Documentation Index > Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 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](/pt/on-premises/release-notes)). | | `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](/pt/on-premises/release-notes)). | | `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](/pt/on-premises/configuration/overleaf-toolkit/redis#enabling-password-authentication) 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](/pt/on-premises/configuration/overleaf-toolkit/branding "mention"). | | `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](/pt/on-premises/configuration/overleaf-toolkit/external-url#outbound-proxy "mention") 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,` no seu `config/variables.env`, em que `` é 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,`, 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](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27). | | `OVERLEAF_DISABLE_LINK_SHARING` | Desativa o recurso de [compartilhamento por link](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27). | | `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](/pt/on-premises/user-and-project-management/project-management#updating-project-compile-timeout). | | `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_DISABLE_LOCAL_LOGIN` | Se definida como `true`, oculta o login com e-mail e senha, para que os usuários só possam fazer login com LDAP, SAML ou OIDC. Só tem efeito quando `EXTERNAL_AUTH` habilita pelo menos um deles (adicionado no Ayakaleaf Pro 6.4.0). | | `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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.