> 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/pl/konfiguracja/overleaf-toolkit/files-and-locations.md).

# Pliki i lokalizacje

Ta strona opisuje pliki konfiguracyjne używane przez Toolkit do konfiguracji wdrożenia Overleaf w Twojej infrastrukturze lokalnej.

### Dane trwałe

Overleaf Toolkit musi przechowywać dane trwałe, takie jak pliki wymagane do kompilacji projektów LaTeX oraz zawartość bazy danych MongoDB. Osiąga się to poprzez podmontowanie kilku katalogów z maszyny hosta do kontenerów Docker i zapisywanie danych w tych katalogach.

#### Katalogi danych

Pole `sharelatex` kontener wymaga katalogu, w którym będzie przechowywać dane związane z kompilacjami LaTeX. Katalog ten jest ustawiany za pomocą `OVERLEAF_DATA_PATH` zmiennej w `config/overleaf.rc`.

Pole `mongo` kontenerze, jeśli jest włączony, wymaga katalogu, w którym będzie przechowywać pliki bazy danych, i to samo dotyczy `redis` kontenera. Katalogi te można również skonfigurować w `config/overleaf.rc`.

#### Uprawnienia do plików

Ponieważ Docker działa jako `root`, katalogi danych będą ostatecznie należeć do użytkownika `root` , nawet jeśli Toolkit jest używany przez użytkownika niebędącego rootem. Nie jest to problem, ale warto o tym pamiętać, jeśli zamierzasz modyfikować dane trwałe spoza kontenerów.

### Lokalizacja pliku konfiguracyjnego

Wszystkie pliki konfiguracyjne należące do użytkownika znajdują się w `katalogu config/` katalogu.

Ten katalog jest **wykluczony** z systemu kontroli wersji git, więc nie zostanie zmieniony podczas aktualizacji kodu Toolkit. Toolkit nie będzie **nie** zmieniać żadnych danych w `katalogu config/` katalogu bez Twojej zgody.

{% hint style="info" %}
Zmiany w plikach konfiguracyjnych nie zostaną automatycznie zastosowane do istniejących kontenerów, nawet jeśli kontener zostanie zatrzymany i uruchomiony ponownie (z `bin/stop` i `bin/start`). Aby zastosować zmiany, uruchom `bin/up`, a w tle `docker compose` automatycznie zastosuje zmiany konfiguracji do nowego kontenera. (Lub uruchom `bin/up -d`, jeśli wolisz nie podłączać się do logów Dockera.)
{% endhint %}

### Pole `overleaf.rc` plik

Pole `config/overleaf.rc` plik zawiera najważniejsze ustawienia konfiguracyjne najwyższego poziomu używane przez Toolkit. Zawiera instrukcje ustawiające zmienne w formacie: `VARIABLE_NAME=value`

Aby zobaczyć zestawienie wszystkich dostępnych opcji konfiguracji, zobacz naszą sekcję ustawień.

### Pole `variables.env` plik

Pole `config/variables.env` plik zawiera zmienne środowiskowe, które są ładowane do `sharelatex` kontenera i używane do konfiguracji mikrousług Overleaf. Obejmują one nazwę aplikacji, wyświetlaną w nagłówku interfejsu webowego, ustawienia wysyłania e-maili oraz inne ustawienia premium, takie jak SSO do użytku z Server Pro.

Aby zobaczyć zestawienie wszystkich dostępnych zmiennych środowiskowych, zobacz [Zmienne środowiskowe](broken://pages/a6e930c58129d3a3462c8f1baa6f4d7d4317672c) sekcji.

### Pole `wersja` plik

Pole `config/version` plik zawiera numer wersji obrazu Docker, który zostanie użyty do utworzenia działającej instancji Twojego serwera Overleaf.

{% hint style="info" %}
Zmiany w tych plikach konfiguracyjnych nie zostaną automatycznie zastosowane do istniejących kontenerów, nawet jeśli kontener zostanie zatrzymany i uruchomiony ponownie (z `bin/stop` i `bin/start`). Aby zastosować zmiany, uruchom `bin/up`, a Toolkit automatycznie utworzy dla Ciebie nowy kontener z zastosowanymi zmianami konfiguracji.
{% endhint %}

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

Jeśli istnieje, `config/docker-compose.override.yml` plik zostanie uwzględniony w wywołaniu `docker compose`. Jest to przydatne do nadpisywania konfiguracji specyficznej dla Docker Compose.

Zobacz [dokumentację docker-compose](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) aby uzyskać więcej szczegółów.


---

# 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/pl/konfiguracja/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.