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

# Pliki i lokalizacje

Ta strona opisuje pliki konfiguracyjne używane przez Toolkit do konfigurowania lokalnego wdrożenia Overleaf.

### Dane trwałe

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

#### Katalogi danych

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

Ustawienie `mongo` kontener, jeśli jest włączony, wymaga katalogu, w którym będą przechowywane jego pliki bazy danych, i to samo dotyczy `redis` kontenera. Te katalogi można również skonfigurować w `config/overleaf.rc`.

#### Uprawnienia plików

Ponieważ Docker działa jako `root`, katalogi danych ostatecznie będą własnością użytkownika `root` nawet jeśli Toolkit jest używany przez użytkownika niebędącego rootem. Nie stanowi to problemu, ale warto o tym wiedzieć, jeśli zamierzasz zmieniać dane trwałe spoza kontenerów.

### Lokalizacja pliku konfiguracyjnego

Wszystkie pliki konfiguracyjne należące do użytkownika znajdują się w `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 `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 (za pomocą `bin/stop` i `bin/start`). Aby zastosować zmiany, uruchom `bin/up`, a w tle `docker compose` automatycznie zastosuje zmiany konfiguracji do nowego kontenera. (Możesz też uruchomić `bin/up -d`, jeśli wolisz nie dołączać do logów Dockera.)
{% endhint %}

### Ustawienie `overleaf.rc` plik

Ustawienie `config/overleaf.rc` plik zawiera najważniejsze główne ustawienia konfiguracji 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ń.

### Ustawienie `variables.env` plik

Ustawienie `config/variables.env` plik zawiera zmienne środowiskowe, które są wczytywane do `sharelatex` kontenera i używane do konfigurowania mikrousług Overleaf. Obejmują one nazwę aplikacji wyświetlaną w nagłówku interfejsu WWW, ustawienia wysyłania wiadomości e-mail oraz inne funkcje 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.

### Ustawienie `wersja` plik

Ustawienie `config/version` plik zawiera numer wersji obrazu Dockera, 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 (za pomocą `bin/stop` i `bin/start`). Aby zastosować zmiany, uruchom `bin/up`, a Toolkit automatycznie utworzy dla Ciebie nowy kontener ze zastosowanymi zmianami konfiguracji.
{% endhint %}

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

Jeśli jest obecny, `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://overleaf-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.