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

# Tiedostot ja sijainnit

Tällä sivulla kuvataan asetustiedostot, joita Toolkit käyttää Overleafin paikallisen käyttöönoton määrittämiseen.

### Pysyvät tiedot

Overleaf Toolkitin on tallennettava 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äkoneelta Docker-kontteihin ja kirjoittamalla tiedot näihin hakemistoihin.

#### Tietohakemistot

Kentän `sharelatex` Kontti tarvitsee hakemiston, johon tallennetaan LaTeX-käännöksiin liittyviä tietoja. Tämä hakemisto asetetaan `OVERLEAF_DATA_PATH` muuttujalla tiedostossa `config/overleaf.rc`.

Kentän `mongo` kontti, jos se on käytössä, tarvitsee hakemiston, johon se tallentaa tietokantatiedostonsa, ja sama pätee myös `redis` konttiin. Nämä hakemistot voidaan myös määrittää `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 siitä on hyvä olla tietoinen, jos aiot muuttaa pysyviä tietoja konttien ulkopuolelta.

### Asetustiedostojen sijainti

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

Tämä hakemisto on **poissuljettu** 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 oteta automaattisesti käyttöön olemassa olevissa konteissa, vaikka kontti pysäytettäisiin ja käynnistettäisiin uudelleen ( `bin/stop` ja `bin/start`). Ota muutokset käyttöön suorittamalla `bin/up`, ja taustalla `docker compose` ottaa asetusten muutokset automaattisesti käyttöön uudessa kontissa. (Tai suorita `bin/up -d`, jos et halua liittää Docker-lokeihin.)
{% endhint %}

### Kentän `overleaf.rc` tiedosto

Kentän `config/overleaf.rc` tiedosto sisältää Toolkitin käyttämät tärkeimmät ylätason asetukset. Se sisältää lauseita, jotka asettavat muuttujia muodossa: `VARIABLE_NAME=value`

Jos haluat nähdä erittelyn kaikista käytettävissä olevista asetusvaihtoehdoista, katso asetukset-osiomme.

### Kentän `variables.env` tiedosto

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

Jos haluat nähdä erittelyn kaikista käytettävissä olevista ympäristömuuttujista, katso [Ympäristömuuttujat](broken://pages/21973f574b41e6ba323df98d218222a9b2512364) osiossa.

### Kentän `versio` tiedosto

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

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

### Kentän `docker-compose.override.yml` tiedosto

Jos se on olemassa, `config/docker-compose.override.yml` tiedosto sisällytetään kutsuun `docker compose`. Tämä on hyödyllistä Docker Compose -kohtaisen asetuksen ohittamiseen.

Katso [docker-compose-dokumentaatio](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://overleaf-pro.ayaka.space/on-premises/fi/maaritys/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.