> 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/files-and-locations.md).

# Ficheiros e localizações

Esta página descreve os ficheiros de configuração que são usados pelo Toolkit para configurar a sua implementação local do Overleaf.

### Dados Persistentes

O Overleaf Toolkit precisa de armazenar dados persistentes, como os ficheiros necessários para compilar projetos LaTeX e o conteúdo da base de dados MongoDB. Isto é conseguido ao montar alguns diretórios da máquina anfitriã nos contentores Docker e ao escrever os dados nesses diretórios.

#### Diretórios de Dados

O `sharelatex` contentor requer um diretório no qual armazenar dados relacionados com compilações LaTeX. Este diretório é definido com a `OVERLEAF_DATA_PATH` variável em `config/overleaf.rc`.

O `mongo` contentor, se estiver ativado, requer um diretório no qual armazenar os seus ficheiros da base de dados, e o mesmo se aplica ao `redis` contentor. Estes diretórios também podem ser configurados em `config/overleaf.rc`.

#### Permissões de Ficheiros

Como o Docker é executado como `root`, os diretórios de dados acabarão por ser propriedade do utilizador `root` , mesmo que o Toolkit esteja a ser usado por um utilizador sem privilégios de root. Isto não é um problema, mas vale a pena ter em atenção se pretender alterar os dados persistentes a partir de fora dos contentores.

### Localização do ficheiro de configuração

Todos os ficheiros de configuração pertencentes ao utilizador encontram-se no diretório `config/` .

Este diretório é **excluído** do sistema de controlo de versões git, pelo que não será alterado ao atualizar o código do Toolkit. O Toolkit não **não** alterará quaisquer dados no diretório `config/` sem a sua अनुमति.

{% hint style="info" %}
As alterações aos ficheiros de configuração não serão aplicadas automaticamente aos contentores existentes, mesmo que o contentor seja parado e reiniciado (com `bin/stop` e `bin/start`). Para aplicar as alterações, execute `bin/up`, e, nos bastidores, `docker compose` aplicará automaticamente as alterações de configuração a um novo contentor. (Ou execute `bin/up -d`, se preferir não se ligar aos registos do Docker.)
{% endhint %}

### O `overleaf.rc` ficheiro

O `config/overleaf.rc` O ficheiro contém as definições de configuração de nível superior mais importantes usadas pelo Toolkit. Contém instruções que definem variáveis, no formato: `VARIABLE_NAME=value`

Para ver uma descrição de todas as opções de configuração disponíveis, consulte a nossa secção de definições.

### O `variables.env` ficheiro

O `config/variables.env` O ficheiro contém variáveis de ambiente que são carregadas para o `sharelatex` contentor e usadas para configurar os microserviços do Overleaf. Estas incluem o nome da aplicação, tal como apresentado no cabeçalho da interface web, definições para envio de emails e outras definições premium, como SSO para utilização com o Server Pro.

Para ver uma descrição de todas as variáveis de ambiente disponíveis, consulte a secção [Variáveis de ambiente](broken://pages/bebd79526d51f42f281ec14e1abe014d835a8048) secção.

### O `versão` ficheiro

O `config/version` O ficheiro contém o número da versão da imagem Docker que será usado para criar a instância em execução do seu servidor Overleaf.

{% hint style="info" %}
As alterações a estes ficheiros de configuração não serão aplicadas automaticamente aos contentores existentes, mesmo que o contentor seja parado e reiniciado (com `bin/stop` e `bin/start`). Para aplicar as suas alterações, execute `bin/up`, e o Toolkit criará automaticamente um novo contentor para si com as alterações de configuração aplicadas.
{% endhint %}

### O `docker-compose.override.yml` ficheiro

Se estiver presente, o `config/docker-compose.override.yml` ficheiro será incluído na invocação de `docker compose`docker-compose. Isto é útil para substituir configurações específicas do Docker Compose.

Consulte a [documentação do docker-compose](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) para mais detalhes.


---

# 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/files-and-locations.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.