> 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/on-premises-cs/konfigurace/overleaf-toolkit/files-and-locations.md).

# Soubory a umístění

Tato stránka popisuje konfigurační soubory, které Toolkit používá ke konfiguraci vašeho lokálního nasazení Overleafu.

### Trvalá data

Overleaf Toolkit potřebuje ukládat trvalá data, jako jsou soubory potřebné ke kompilaci projektů LaTeX a obsah databáze MongoDB. Toho je dosaženo připojením několika adresářů z hostitelského stroje do kontejnerů Docker a zapisováním dat do těchto adresářů.

#### Datové adresáře

Pole `sharelatex` kontejner vyžaduje adresář, ve kterém bude ukládat data související s kompilacemi LaTeX. Tento adresář se nastavuje pomocí `OVERLEAF_DATA_PATH` proměnné v `config/overleaf.rc`.

Pole `mongo` kontejner, pokud je povolen, vyžaduje adresář, ve kterém bude ukládat své databázové soubory, a totéž platí pro kontejner `redis` Tyto adresáře lze také nakonfigurovat v `config/overleaf.rc`.

#### Oprávnění souborů

Protože Docker běží jako `root`, budou adresáře s daty nakonec vlastněny uživatelem `root` , i když Toolkit používá uživatel bez oprávnění root. To není problém, ale je dobré o tom vědět, pokud hodláte měnit trvalá data zvenčí kontejnerů.

### Umístění konfiguračních souborů

Všechny konfigurační soubory ve vlastnictví uživatele se nacházejí v `config/` adresáři.

Tento adresář je **vyloučen** ze systému správy verzí git, takže se nezmění při aktualizaci kódu Toolkitu. Toolkit nebude **ne** měnit žádná data v `config/` adresáři bez vašeho svolení.

{% hint style="info" %}
Změny v konfiguračních souborech nebudou automaticky použity pro existující kontejnery, i když je kontejner zastaven a znovu spuštěn (s `bin/stop` a `bin/start`). Chcete-li změny použít, spusťte `bin/up`, a na pozadí `docker compose` automaticky použije změny konfigurace do nového kontejneru. (Nebo spusťte `bin/up -d`, pokud se nechcete připojovat k protokolům Dockeru.)
{% endhint %}

### Pole `overleaf.rc` soubor

Pole `config/overleaf.rc` soubor obsahuje nejdůležitější globální konfigurační nastavení používaná Toolkitem. Obsahuje příkazy, které nastavují proměnné ve formátu: `VARIABLE_NAME=value`

Chcete-li zobrazit rozpis všech dostupných možností konfigurace, podívejte se do sekce nastavení.

### Pole `variables.env` soubor

Pole `config/variables.env` soubor obsahuje proměnné prostředí, které se načítají do `sharelatex` kontejneru a používají se ke konfiguraci mikroslužeb Overleafu. Patří sem název aplikace zobrazovaný v záhlaví webového rozhraní, nastavení pro odesílání e-mailů a další prémiová nastavení, jako je SSO pro použití se Server Pro.

Chcete-li zobrazit rozpis všech dostupných proměnných prostředí, podívejte se na [Proměnné prostředí](broken://pages/7032811494e0197360851b99088110b0a3cd1079) sekci.

### Pole `verze` soubor

Pole `config/version` soubor obsahuje číslo verze obrazu Dockeru, který bude použit k vytvoření běžící instance vašeho serveru Overleaf.

{% hint style="info" %}
Změny v těchto konfiguračních souborech nebudou automaticky použity pro existující kontejnery, i když je kontejner zastaven a znovu spuštěn (s `bin/stop` a `bin/start`). Chcete-li změny použít, spusťte `bin/up`, a Toolkit za vás automaticky vytvoří nový kontejner s použitými změnami konfigurace.
{% endhint %}

### Pole `docker-compose.override.yml` soubor

Pokud je přítomen, `config/docker-compose.override.yml` soubor bude zahrnut do volání `docker compose`. To je užitečné pro přepsání konfigurace specifické pro Docker Compose.

Viz [dokumentace k docker-compose](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) pro více informací.


---

# 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/on-premises-cs/konfigurace/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.