> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-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`. As linhas que começam com `#` são tratadas como comentários.

{% hint style="info" %}
É necessário recriar os contentores Docker depois de alterar qualquer coisa em `overleaf.rc` ou `variables.env` executando `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 quando se executam várias instâncias do Overleaf num único anfitrião, uma vez que 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 conforme usada pelo contentor da aplicação Server Pro/CE. Isto é apenas o nome da imagem Docker; a tag 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>- Community Edition: <code>sharelatex/sharelatex</code></p>                                                                                                                                                                                                                                        |
| `SERVER_PRO`                 | <p>Quando definido como <code>true</code>, indica ao Toolkit para usar a imagem Server Pro (<code>quay.io/sharelatex/sharelatex-pro</code>), em vez da imagem Server CE predefinida (<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 do utilizador.<br><br>- <strong>Padrão:</strong> <code>false</code></p>                                                                                                                                                                                                                                          |
| `GIT_BRIDGE_IMAGE`           | <p>Imagem Docker conforme usada pelo contentor git-bridge (apenas Server Pro). Isto é apenas o nome da imagem Docker; a tag 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 (a começar por um `/`), ou relativo ao diretório base do Toolkit.                                                                                                                                                                                                                                                                                                                                              |
| `GIT_BRIDGE_LOG_LEVEL`       | <p>Configura 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>, indica ao Toolkit para usar a <strong>Sibling Containers</strong> técnica para compilar projetos em ambientes isolados separados, 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>, indica ao Toolkit para obter 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 anfitrião.<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 contentor principal <code>sharelatex</code> , e usado para armazenar os dados de compilação. Pode ser um caminho completo (a começar por 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 aos quais o contentor se ligará. Por exemplo, se isto estiver definido para <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> tem de 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 para <code>8099</code> e <code>OVERLEAF\_LISTEN\_IP</code> estiver definido para <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 contentor principal <code>sharelatex</code> contentor, e usado para disponibilizar os registos da aplicação no anfitrião Docker. Pode ser um caminho completo (a começar por um <code>/</code>), ou relativo ao diretório base do Toolkit. Remova a entrada de configuração para desativar a montagem 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>, indica ao Toolkit para criar um contentor MongoDB para alojar a base de dados. Quando definido para <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 do 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 (a começar por um <code>/</code>), ou relativo ao diretório base do Toolkit. Esta opção afeta apenas o contentor local <code>mongo</code> 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 conforme usada pelo contentor MongoDB. Isto é apenas o nome da imagem Docker; a tag da imagem Docker deve ir em <code>MONGO\_VERSION</code> (veja abaixo).<br><br>- <strong>Padrão:</strong> <code>mongo</code></p>                                                                                                                                                                                                                   |
| `MONGO_VERSION`   | <p>Versão do MongoDB conforme usada pelo contentor MongoDB. O valor tem de 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>, indica ao Toolkit para criar um contentor Redis para alojar a base de dados Redis. Quando definido para <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 (a começar por um <code>/</code>), ou relativo ao diretório base do Toolkit. Esta opção afeta apenas o contentor local <code>redis</code> 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>, indica 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 do 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 aos quais o contentor proxy TLS se ligará para HTTPS. Por exemplo, se isto estiver definido para <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 aos quais o contentor proxy TLS se ligará para redirecionamento HTTP. Por exemplo, se isto estiver definido para <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 para <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://ayakaleaf-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.
