> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/pt/configuracao/overleaf-toolkit/toolkit-settings.md).

# Definições do Toolkit

Esta página descreve as variáveis de ambiente suportadas no `config/overleaf.rc` ficheiro para implementações do Toolkit.

O `config/overleaf.rc` ficheiro consiste em definições de variáveis na forma `NAME=value`. Linhas que começam com `#` são tratadas como comentários.

{% hint style="info" %}
É necessário que recrie os contentores Docker após alterar qualquer coisa em `overleaf.rc` ou `variables.env` ao executar `bin/up`.
{% endhint %}

## Contentor

### `sharelatex`

| Nome                         | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `PROJECT_NAME`               | <p>Define o valor de <code>--project-name</code> sinalizador fornecido a <code>docker-compose</code>. Isto é útil ao executar várias instâncias do Overleaf num único host, pois cada instância pode ter um nome de projeto diferente.<br><br>- <strong>Predefinição</strong>: <code>overleaf</code></p>                                                                                                                                                                                                                                                                                     |
| `OVERLEAF_IMAGE_NAME`        | <p>Imagem Docker usada pelo contentor da aplicação Server Pro/CE. Isto é apenas o nome da imagem Docker; a etiqueta da imagem Docker é obtida de <code>config/version</code>.<br><br>- <strong>Padrão:</strong><br>- Server Pro: <code>quay.io/sharelatex/sharelatex-pro</code><br>- Edição Comunitária: <code>sharelatex/sharelatex</code></p>                                                                                                                                                                                                                                              |
| `SERVER_PRO`                 | <p>Quando definido como <code>true</code>, diz ao Toolkit para usar a imagem do Server Pro (<code>quay.io/sharelatex/sharelatex-pro</code>), em vez da imagem padrão do Server CE (<code>sharelatex/sharelatex</code>).<br><br>- <strong>Predefinição</strong>: <code>false</code></p>                                                                                                                                                                                                                                                                                                       |
| `GIT_BRIDGE_ENABLED`         | <p>Defina como <code>true</code> para ativar a funcionalidade git-bridge (apenas Server Pro). Para mais informações, consulte a <a href="https://www.overleaf.com/learn/how-to/Git_integration"><https://www.overleaf.com/learn/how-to/Git_integration></a> documentação para utilizadores.<br><br>- <strong>Padrão:</strong> <code>false</code></p>                                                                                                                                                                                                                                         |
| `GIT_BRIDGE_IMAGE`           | <p>Imagem Docker usada pelo contentor git-bridge (apenas Server Pro). Isto é apenas o nome da imagem Docker; a etiqueta da imagem Docker é obtida de <code>config/version</code>.<br><br>- <strong>Padrão:</strong> <code>quay.io/sharelatex/git-bridge</code></p>                                                                                                                                                                                                                                                                                                                           |
| `GIT_BRIDGE_DATA_PATH`       | Define o caminho para o diretório que será montado no `git-bridge` contentor (apenas Server Pro) e usado para armazenar os repositórios git. Pode ser um caminho completo (que começa com um `/`), ou relativo ao diretório base do Toolkit.                                                                                                                                                                                                                                                                                                                                                 |
| `GIT_BRIDGE_LOG_LEVEL`       | <p>Configure o nível de registo do <code>git-bridge</code> contentor. Níveis disponíveis: <code>TRACE</code>, <code>DEBUG</code>, <code>INFO</code>, <code>WARN</code>, <code>ERROR</code>.<br><br>- <strong>Padrão:</strong> <code>INFO</code></p>                                                                                                                                                                                                                                                                                                                                          |
| `SIBLING_CONTAINERS_ENABLED` | <p>Quando definido como <code>true</code>, diz ao Toolkit para usar a <strong>Contêineres irmãos</strong> técnica para compilar projetos em sandboxes separadas, usando um contentor Docker separado para cada projeto. Consulte a documentação \<server-pro-only-configuration/sandboxed-compiles> para mais informações.<br><br>- <strong>Requer:</strong> <code>SERVER\_PRO=true</code><br>- <strong>Padrão:</strong> <code>true</code></p>                                                                                                                                               |
| `SIBLING_CONTAINERS_PULL`    | <p>Quando definido como <code>true</code>, diz ao Toolkit para descarregar automaticamente todas as imagens TeX Live definidas usando <code>ALL\_TEX\_LIVE\_DOCKER\_IMAGES</code> no <strong>config/variables.env</strong> ficheiro ao usar o <code>bin/up</code> comando.<br><br>- <strong>Padrão:</strong> <code>true</code></p>                                                                                                                                                                                                                                                           |
| `DOCKER_SOCKET_PATH`         | <p>Define o caminho para o socket do Docker na máquina anfitriã (a máquina que executa o Toolkit). Quando <code>SIBLING\_CONTAINERS\_ENABLED</code> é <code>true</code>, o socket será montado no contentor para permitir que o serviço de compilação crie novos contentores Docker no host.<br><br>- <strong>Requer:</strong> <code>SIBLING\_CONTAINERS\_ENABLED=true</code><br>- <strong>Padrão:</strong> <code>/var/run/docker.sock</code></p>                                                                                                                                            |
| `OVERLEAF_DATA_PATH`         | <p>Define o caminho para o diretório que será montado no principal <code>sharelatex</code> contentor e usado para armazenar dados de compilação. Pode ser um caminho completo (que começa com um <code>/</code>), ou relativo ao diretório base do Toolkit.<br><br>- <strong>Padrão:</strong> <code>data/overleaf</code></p>                                                                                                                                                                                                                                                                 |
| `OVERLEAF_LISTEN_IP`         | <p>Define o(s) endereço(s) IP do anfitrião ao(s) qual(is) o contentor se ligará. Por exemplo, se isto estiver definido como <code>0.0.0.0</code>, então a interface web estará disponível em qualquer endereço IP do anfitrião. Para acesso direto ao contentor, o valor de <code>OVERLEAF\_LISTEN\_IP</code> deve ser definido para o seu endereço IP público. Definir <code>OVERLEAF\_LISTEN\_IP</code> para <code>0.0.0.0</code> ou o IP externo do seu anfitrião normalmente causará erros quando usado em conjunto com o .<br><br>- <strong>Padrão:</strong> <code>127.0.0.1</code></p> |
| `OVERLEAF_PORT`              | <p>Define a porta do anfitrião à qual o contentor se ligará. Por exemplo, se isto estiver definido como <code>8099</code> e <code>OVERLEAF\_LISTEN\_IP</code> estiver definido como <code>127.0.0.1</code>, então a interface web estará disponível em <code><http://localhost:8099></code>.<br><br>- <strong>Padrão:</strong> <code>80</code></p>                                                                                                                                                                                                                                           |
| `OVERLEAF_LOG_PATH`          | <p>Define o caminho para o diretório que será montado no principal <code>sharelatex</code> contentor e usado para disponibilizar os registos da aplicação no anfitrião Docker. Pode ser um caminho completo (que começa com um <code>/</code>), ou relativo ao diretório base do Toolkit. Remova a entrada de configuração para desativar a montagem por bind. Quando não estiver definido, os registos serão descartados ao recriar o contentor.<br><br>Consulte para obter informações sobre registo.<br><br>- <strong>Padrão:</strong> não definido</p>                                   |

***

### `mongo`

| Nome              | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `MONGO_ENABLED`   | <p>Quando definido como <code>true</code>, diz ao Toolkit para criar um contentor MongoDB para alojar a base de dados. Quando definido como <code>false</code>, este contentor não será criado, e o sistema usará a base de dados MongoDB especificada por <code>MONGO\_URL</code> em vez disso.<br><br>- <strong>Predefinição</strong>: <code>true</code></p>                                                                                         |
| `MONGO_URL`       | <p>Especifica o URL de ligação MongoDB a usar quando <code>MONGO\_ENABLED</code> é <code>false</code>.<br><br>- <strong>Predefinição</strong>: não definido</p>                                                                                                                                                                                                                                                                                        |
| `MONGO_DATA_PATH` | <p>Define o caminho para o diretório que será montado no <code>mongo</code> contentor e usado para armazenar a base de dados MongoDB. Pode ser um caminho completo (que começa com um <code>/</code>), ou relativo ao diretório base do toolkit. Esta opção afeta apenas o <code>mongo</code> contentor local que é criado quando <code>MONGO\_ENABLED</code> é <code>true</code>.<br><br>- <strong>Predefinição</strong>: <code>data/mongo</code></p> |
| `MONGO_IMAGE`     | <p>Imagem Docker usada pelo contentor MongoDB. Isto é apenas o nome da imagem Docker; a etiqueta da imagem Docker deve ser colocada em <code>MONGO\_VERSION</code> (ver abaixo).<br><br>- <strong>Padrão:</strong> <code>mongo</code></p>                                                                                                                                                                                                              |
| `MONGO_VERSION`   | <p>Versão do MongoDB usada pelo contentor MongoDB. O valor deve começar com a versão principal do MongoDB e um ponto, por exemplo <code>6.0</code> ou <code>6.0-with-suffix</code>.<br><br>- <strong>Padrão:</strong> <code>6.0</code></p>                                                                                                                                                                                                             |

***

### `redis`

| Nome                    | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `REDIS_ENABLED`         | <p>Quando definido como <code>true</code>, diz ao Toolkit para criar um contentor Redis para alojar a base de dados Redis. Quando definido como <code>false</code>, este contentor não será criado, e o sistema usará a base de dados Redis especificada por <code>REDIS\_HOST</code> e <code>REDIS\_PORT</code> em vez disso.<br><br>- <strong>Predefinição</strong>: <code>true</code></p>                                                         |
| `REDIS_HOST`            | <p>Especifica o anfitrião Redis a usar quando <code>REDIS\_ENABLED</code> é <code>false</code>.<br><br>- <strong>Predefinição</strong>: não definido</p>                                                                                                                                                                                                                                                                                             |
| `REDIS_PORT`            | <p>Especifica a porta Redis a usar quando <code>REDIS\_ENABLED</code> é <code>false</code>.<br><br>- <strong>Predefinição</strong>: não definido</p>                                                                                                                                                                                                                                                                                                 |
| `REDIS_DATA_PATH`       | <p>Define o caminho para o diretório que será montado no <code>redis</code> contentor e usado para armazenar a base de dados Redis. Pode ser um caminho completo (que começa com um <code>/</code>), ou relativo ao diretório base do Toolkit. Esta opção afeta apenas o <code>redis</code> contentor local que é criado quando <code>REDIS\_ENABLED</code> é <code>true</code>.<br><br>- <strong>Predefinição</strong>: <code>data/redis</code></p> |
| `REDIS_AOF_PERSISTENCE` | <p>Ative a persistência AOF (Append Only File) para o Redis. Esta é a <strong>recomendada</strong> configuração recomendada para a persistência do Redis.<br><br>Para mais detalhes, consulte a secção <../../../maintenance/data-and-backups#aof-append-only-file> em <../../maintenance/data-and-backups>.<br><br>- <strong>Padrão:</strong> <code>true</code></p>                                                                                 |

***

### `nginx`

| Nome                   | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `NGINX_ENABLED`        | <p>Quando definido como <code>true</code>, diz ao Toolkit para criar um contentor NGINX para atuar como proxy TLS.<br><br>- <strong>Predefinição</strong>: <code>false</code></p>                                                                                                                                                                                                                                                                                                                                                                              |
| `NGINX_CONFIG_PATH`    | <p>Caminho para o ficheiro de configuração NGINX a usar para o proxy TLS.<br><br>- <strong>Predefinição</strong>: <code>config/nginx/nginx.conf</code></p>                                                                                                                                                                                                                                                                                                                                                                                                     |
| `NGINX_TLS_LISTEN_IP`  | <p>Define o(s) endereço(s) IP do anfitrião ao(s) qual(is) o contentor proxy TLS se ligará para HTTPS. Por exemplo, se isto estiver definido como <code>0.0.0.0</code> então a interface web HTTPS estará disponível em qualquer endereço IP do anfitrião. Normalmente, isto deve ser definido para o IP externo do seu anfitrião.<br><br>- <strong>Predefinição</strong>: <code>127.0.1.1</code></p>                                                                                                                                                           |
| `NGINX_HTTP_LISTEN_IP` | <p>Define o(s) endereço(s) IP do anfitrião ao(s) qual(is) o contentor proxy TLS se ligará para redirecionamento HTTP. Por exemplo, se isto estiver definido como <code>127.0.1.1</code> então as ligações HTTP para <code>127.0.1.1</code> serão redirecionadas para a interface web HTTPS. Normalmente, isto deve ser definido para o IP externo do seu anfitrião. Não o defina como <code>0.0.0.0</code> pois isso normalmente causará um conflito com <code>OVERLEAF\_LISTEN\_IP</code>.<br><br>- <strong>Predefinição</strong>: <code>127.0.1.1</code></p> |
| `NGINX_HTTP_PORT`      | <p>Define a porta do anfitrião à qual o contentor proxy TLS se ligará para HTTP.<br><br>- <strong>Predefinição</strong>: <code>80</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `TLS_PORT`             | <p>Define a porta do anfitrião à qual o contentor proxy TLS se ligará para HTTPS.<br><br>- <strong>Predefinição</strong>: <code>443</code></p>                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `TLS_PRIVATE_KEY_PATH` | <p>Caminho para a chave privada a usar para o proxy TLS.<br><br>- <strong>Predefinição</strong>: <code>config/nginx/certs/overleaf\_key.pem</code></p>                                                                                                                                                                                                                                                                                                                                                                                                         |
| `TLS_CERTIFICATE_PATH` | <p>Caminho para o certificado público a usar para o proxy TLS.<br><br>- <strong>Predefinição</strong>: <code>config/nginx/certs/overleaf\_certificate.pem</code></p>                                                                                                                                                                                                                                                                                                                                                                                           |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/pt/configuracao/overleaf-toolkit/toolkit-settings.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
