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

# Tiedostot ja sijainnit

Tämä sivu kuvaa asetustiedostoja, joita Toolkit käyttää Overleafin paikallisen käyttöönoton määrittämiseen.

### Pysyvät tiedot

Overleaf Toolkitin täytyy tallentaa pysyviä tietoja, kuten LaTeX-projektien kääntämiseen tarvittavat tiedostot ja MongoDB-tietokannan sisältö. Tämä tehdään liittämällä muutama hakemisto isäntäkoneesta Docker-säilöihin ja kirjoittamalla tiedot näihin hakemistoihin.

#### Tietohakemistot

Se `sharelatex` säilö tarvitsee hakemiston, johon tallentaa LaTeX-käännöksiin liittyvät tiedot. Tämä hakemisto määritetään `OVERLEAF_DATA_PATH` muuttujalla kohdassa `config/overleaf.rc`.

Se `mongo` säilö, jos se on käytössä, tarvitsee hakemiston tietokantatiedostojensa tallentamiseen, ja sama pätee `redis` säilöön. Nämä hakemistot voidaan määrittää myös kohdassa `config/overleaf.rc`.

#### Tiedostojen käyttöoikeudet

Koska Docker toimii käyttäjänä `root`, tietohakemistojen omistajaksi tulee `root` käyttäjä, vaikka Toolkitia käyttäisi ei-root-käyttäjä. Tämä ei ole ongelma, mutta se on hyvä tiedostaa, jos aiot muokata pysyviä tietoja säilöiden ulkopuolelta.

### Asetustiedostojen sijainti

Kaikki käyttäjän omistamat asetustiedostot löytyvät `config/` hakemistosta.

Tämä hakemisto on **rajattu pois** git-versionhallintajärjestelmästä, joten Toolkit-koodin päivittäminen ei muuta sitä. Toolkit ei **ei** muuta mitään tietoja `config/` hakemistossa ilman lupaasi.

{% hint style="info" %}
Muutoksia asetustiedostoihin ei sovelleta automaattisesti olemassa oleviin säilöihin, vaikka säilö pysäytettäisiin ja käynnistettäisiin uudelleen (komennolla `bin/stop` ja `bin/start`). Ota muutokset käyttöön suorittamalla `bin/up`, ja taustalla `docker compose` soveltaa asetusten muutokset automaattisesti uuteen säilöön. (Tai suorita `bin/up -d`, jos et halua liittyä Docker-lokeihin.)
{% endhint %}

### Se `overleaf.rc` tiedosto

Se `config/overleaf.rc` tiedosto sisältää tärkeimmät Toolkitin käyttämät ylimmän tason asetukset. Se sisältää lausekkeita, jotka asettavat muuttujia muodossa: `MUUTTUJAN_NIMI=arvo`

Katso kaikkien saatavilla olevien asetusten erittely asetukset-osiostamme.

### Se `variables.env` tiedosto

Se `config/variables.env` tiedosto sisältää ympäristömuuttujia, jotka ladataan `sharelatex` säilöön ja joita käytetään Overleaf-mikropalvelujen määrittämiseen. Näihin kuuluvat sovelluksen nimi, sellaisena kuin se näkyy verkkokäyttöliittymän otsikossa, sähköpostien lähetyksen asetukset sekä muut premium-asetukset, kuten SSO Server Pron kanssa käytettäväksi.

Katso kaikkien saatavilla olevien ympäristömuuttujien erittely kohdasta [Ympäristömuuttujat](broken://pages/21973f574b41e6ba323df98d218222a9b2512364) osiossa.

### Se `versio` tiedosto

Se `config/version` tiedosto sisältää Docker-kuvan versionumeron, jota käytetään Overleaf-palvelimesi käynnissä olevan esiintymän luomiseen.

{% hint style="info" %}
Muutoksia näihin asetustiedostoihin ei sovelleta automaattisesti olemassa oleviin säilöihin, vaikka säilö pysäytettäisiin ja käynnistettäisiin uudelleen (komennolla `bin/stop` ja `bin/start`). Ota muutoksesi käyttöön suorittamalla `bin/up`, ja Toolkit luo automaattisesti uuden säilön, johon asetusten muutokset on otettu käyttöön.
{% endhint %}

### Se `docker-compose.override.yml` tiedosto

Jos olemassa, niin `config/docker-compose.override.yml` tiedosto sisällytetään kutsuun `docker compose`. Tämä on hyödyllistä Docker Composeen liittyvien asetusten ohittamiseen.

Katso [docker-compose-dokumentaatiota](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) lisätietoja varten.


---

# 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/fi/konfiguraatio/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.