> 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/toolkit-settings.md).

# Toolkitin asetukset

Tämä sivu kuvaa ympäristömuuttujat, joita tuetaan `config/overleaf.rc` Toolkit-käyttöönottojen tiedostossa.

Kentän `config/overleaf.rc` tiedosto koostuu muuttujamäärityksistä muodossa `NAME=value`. Rivit, jotka alkavat merkillä `#` käsitellään kommentteina.

{% hint style="info" %}
Docker-kontit on luotava uudelleen, kun muutat jotain tiedostossa `overleaf.rc` tai `variables.env` ajamalla `bin/up`.
{% endhint %}

## Kontti

### `sharelatex`

| Nimi                         | Kuvaus                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `PROJECT_NAME`               | <p>Asettaa arvon <code>--project-name</code> lipuksi, joka annetaan <code>docker-compose</code>. Tämä on hyödyllistä, kun samalla isäntäkoneella ajetaan useita Overleaf-instansseja, sillä jokaisella instanssilla voi olla eri projektin nimi.<br><br>- <strong>--continue</strong>: <code>Overleaf</code></p>                                                                                                                                                                                                                                       |
| `OVERLEAF_IMAGE_NAME`        | <p>Docker-kuva, jota Server Pro/CE -sovelluskontti käyttää. Tämä on vain Docker-kuvan nimi; Docker-kuvan tagi haetaan kohteesta <code>config/version</code>.<br><br>- <strong>Oletus:</strong><br>- Server Pro: <code>quay.io/sharelatex/sharelatex-pro</code><br>- Community Edition: <code>sharelatex/sharelatex</code></p>                                                                                                                                                                                                                          |
| `SERVER_PRO`                 | <p>Kun arvoksi asetetaan <code>true</code>, ohjaa Toolkitin käyttämään Server Pro -kuvaa (<code>quay.io/sharelatex/sharelatex-pro</code>), oletusarvoisen Server CE -kuvan (<code>sharelatex/sharelatex</code>).<br><br>- <strong>--continue</strong>: <code>false</code></p>                                                                                                                                                                                                                                                                          |
| `GIT_BRIDGE_ENABLED`         | <p>Aseta arvoksi <code>true</code> ottaakseen käyttöön git-bridge-ominaisuuden (vain Server Pro). Lisätietoja on <a href="https://www.overleaf.com/learn/how-to/Git_integration"><https://www.overleaf.com/learn/how-to/Git_integration></a> käyttöohjeista.<br><br>- <strong>Oletus:</strong> <code>false</code></p>                                                                                                                                                                                                                                  |
| `GIT_BRIDGE_IMAGE`           | <p>Docker-kuva, jota git-bridge-kontti käyttää (vain Server Pro). Tämä on vain Docker-kuvan nimi; Docker-kuvan tagi haetaan kohteesta <code>config/version</code>.<br><br>- <strong>Oletus:</strong> <code>quay.io/sharelatex/git-bridge</code></p>                                                                                                                                                                                                                                                                                                    |
| `GIT_BRIDGE_DATA_PATH`       | Asettaa polun hakemistoon, joka liitetään `git-bridge` konttiin (vain Server Pro), ja jota käytetään git-tietovarastojen tallentamiseen. Tämä voi olla joko täysi polku (joka alkaa merkillä `/`), tai suhteellinen Toolkitin perushakemistoon nähden.                                                                                                                                                                                                                                                                                                 |
| `GIT_BRIDGE_LOG_LEVEL`       | <p>Määritä <code>git-bridge</code> kontin lokitustaso. Käytettävissä olevat tasot: <code>TRACE</code>, <code>DEBUG</code>, <code>INFO</code>, <code>WARN</code>, <code>ERROR</code>.<br><br>- <strong>Oletus:</strong> <code>INFO</code></p>                                                                                                                                                                                                                                                                                                           |
| `SIBLING_CONTAINERS_ENABLED` | <p>Kun arvoksi asetetaan <code>true</code>, ohjaa Toolkitin käyttämään <strong>Sisarkontit</strong> tekniikkaa projektien kääntämiseen erillisissä hiekkalaatikoissa käyttämällä erillistä Docker-konttia jokaista projektia varten. Lisätietoja on \<server-pro-only-configuration/sandboxed-compiles>-dokumentaatiossa.<br><br>- <strong>Vaatii:</strong> <code>SERVER\_PRO=true</code><br>- <strong>Oletus:</strong> <code>true</code></p>                                                                                                          |
| `SIBLING_CONTAINERS_PULL`    | <p>Kun arvoksi asetetaan <code>true</code>, ohjaa Toolkitin lataamaan automaattisesti kaikki TeX Live -kuvat, jotka on asetettu käyttämällä <code>ALL\_TEX\_LIVE\_DOCKER\_IMAGES</code> tiedostossa <strong>config/variables.env</strong> tiedostoa käytettäessä <code>bin/up</code> komentoa.<br><br>- <strong>Oletus:</strong> <code>true</code></p>                                                                                                                                                                                                 |
| `DOCKER_SOCKET_PATH`         | <p>Asettaa polun Dockerin socketiin isäntäkoneella (koneella, jossa Toolkit toimii). Kun <code>SIBLING\_CONTAINERS\_ENABLED</code> on <code>true</code>, socket liitetään konttiin, jotta kääntäjäpalvelu voi käynnistää uusia Docker-kontteja isäntäkoneella.<br><br>- <strong>Vaatii:</strong> <code>SIBLING\_CONTAINERS\_ENABLED=true</code><br>- <strong>Oletus:</strong> <code>/var/run/docker.sock</code></p>                                                                                                                                    |
| `OVERLEAF_DATA_PATH`         | <p>Asettaa polun hakemistoon, joka liitetään pää <code>sharelatex</code> konttiin, ja jota käytetään käännösaineiston tallentamiseen. Tämä voi olla joko täysi polku (joka alkaa merkillä <code>/</code>), tai suhteellinen Toolkitin perushakemistoon nähden.<br><br>- <strong>Oletus:</strong> <code>data/overleaf</code></p>                                                                                                                                                                                                                        |
| `OVERLEAF_LISTEN_IP`         | <p>Asettaa isäntäkoneen IP-osoitteen(t), joihin kontti sitoutuu. Esimerkiksi, jos tämä on asetettu arvoon <code>0.0.0.0</code>, niin verkkokäyttöliittymä on saatavilla missä tahansa isäntäkoneen IP-osoitteessa. Suoraa konttipääsyä varten arvon <code>OVERLEAF\_LISTEN\_IP</code> on oltava julkinen IP-osoitteesi. Asetus <code>OVERLEAF\_LISTEN\_IP</code> joko <code>0.0.0.0</code> tai isäntäkoneesi ulkoinen IP-osoite aiheuttaa yleensä virheitä käytettäessä yhdessä . kanssa.<br><br>- <strong>Oletus:</strong> <code>127.0.0.1</code></p> |
| `OVERLEAF_PORT`              | <p>Asettaa isäntäkoneen portin, johon kontti sitoutuu. Esimerkiksi, jos tämä on asetettu arvoon <code>8099</code> ja <code>OVERLEAF\_LISTEN\_IP</code> on asetettu arvoon <code>127.0.0.1</code>, niin verkkokäyttöliittymä on saatavilla osoitteessa <code><http://localhost:8099></code>.<br><br>- <strong>Oletus:</strong> <code>80</code></p>                                                                                                                                                                                                      |
| `OVERLEAF_LOG_PATH`          | <p>Asettaa polun hakemistoon, joka liitetään pää <code>sharelatex</code> konttiin, ja jota käytetään sovelluslokien tekemiseen saataviksi Docker-isännällä. Tämä voi olla joko täysi polku (joka alkaa merkillä <code>/</code>), tai suhteellinen Toolkitin perushakemistoon nähden. Poista asetusrivi ottaaksesi sidoksen poiston pois käytöstä. Kun sitä ei ole asetettu, lokit hylätään konttia luotaessa uudelleen.<br><br>Katso lisätietoja lokituksesta.<br><br>- <strong>Oletus:</strong> ei asetettu</p>                                       |

***

### `mongo`

| Nimi              | Kuvaus                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `MONGO_ENABLED`   | <p>Kun arvoksi asetetaan <code>true</code>, ohjaa Toolkitin luomaan MongoDB-kontin tietokannan isännöimiseksi. Kun se on asetettu arvoon <code>false</code>, tätä konttia ei luoda, ja järjestelmä käyttää MongoDB-tietokantaa, joka on määritetty kohdassa <code>MONGO\_URL</code> sen sijaan.<br><br>- <strong>--continue</strong>: <code>true</code></p>                                                                                                             |
| `MONGO_URL`       | <p>Määrittää MongoDB-yhteys-URL:n, jota käytetään, kun <code>MONGO\_ENABLED</code> on <code>false</code>.<br><br>- <strong>--continue</strong>: ei asetettu</p>                                                                                                                                                                                                                                                                                                         |
| `MONGO_DATA_PATH` | <p>Asettaa polun hakemistoon, joka liitetään <code>mongo</code> konttiin, ja jota käytetään MongoDB-tietokannan tallentamiseen. Tämä voi olla joko täysi polku (joka alkaa merkillä <code>/</code>), tai suhteellinen toolkitin perushakemistoon nähden. Tämä vaihtoehto vaikuttaa vain paikalliseen <code>mongo</code> konttiin, joka luodaan, kun <code>MONGO\_ENABLED</code> on <code>true</code>.<br><br>- <strong>--continue</strong>: <code>data/mongo</code></p> |
| `MONGO_IMAGE`     | <p>Docker-kuva, jota MongoDB-kontti käyttää. Tämä on vain Docker-kuvan nimi; Docker-kuvan tagin tulisi mennä kohtaan <code>MONGO\_VERSION</code> (katso alla).<br><br>- <strong>Oletus:</strong> <code>mongo</code></p>                                                                                                                                                                                                                                                 |
| `MONGO_VERSION`   | <p>MongoDB-versio, jota MongoDB-kontti käyttää. Arvon on alettava MongoDB:n pääversiolla ja pisteellä, esim. <code>6.0</code> tai <code>6.0-with-suffix</code>.<br><br>- <strong>Oletus:</strong> <code>6.0</code></p>                                                                                                                                                                                                                                                  |

***

### `redis`

| Nimi                    | Kuvaus                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `REDIS_ENABLED`         | <p>Kun arvoksi asetetaan <code>true</code>, ohjaa Toolkitin luomaan Redis-kontin redis-tietokannan isännöimiseksi. Kun se on asetettu arvoon <code>false</code>, tätä konttia ei luoda, ja järjestelmä käyttää Redis-tietokantaa, joka on määritetty kohdassa <code>REDIS\_HOST</code> ja <code>REDIS\_PORT</code> sen sijaan.<br><br>- <strong>--continue</strong>: <code>true</code></p>                                                                            |
| `REDIS_HOST`            | <p>Määrittää Redis-isännän, jota käytetään, kun <code>REDIS\_ENABLED</code> on <code>false</code>.<br><br>- <strong>--continue</strong>: ei asetettu</p>                                                                                                                                                                                                                                                                                                              |
| `REDIS_PORT`            | <p>Määrittää Redis-portin, jota käytetään, kun <code>REDIS\_ENABLED</code> on <code>false</code>.<br><br>- <strong>--continue</strong>: ei asetettu</p>                                                                                                                                                                                                                                                                                                               |
| `REDIS_DATA_PATH`       | <p>Asettaa polun hakemistoon, joka liitetään <code>redis</code> konttiin, ja jota käytetään Redis-tietokannan tallentamiseen. Tämä voi olla joko täysi polku (joka alkaa merkillä <code>/</code>), tai suhteellinen Toolkitin perushakemistoon nähden. Tämä vaihtoehto vaikuttaa vain paikalliseen <code>redis</code> konttiin, joka luodaan, kun <code>REDIS\_ENABLED</code> on <code>true</code>.<br><br>- <strong>--continue</strong>: <code>data/redis</code></p> |
| `REDIS_AOF_PERSISTENCE` | <p>Ota Redisille käyttöön AOF-pysyvyys (Append Only File). Tämä on <strong>suositeltu</strong> määritys Redisin pysyvyyttä varten.<br><br>Lisätietoja on kohdassa <../../../maintenance/data-and-backups#aof-append-only-file> luvussa <../../maintenance/data-and-backups>.<br><br>- <strong>Oletus:</strong> <code>true</code></p>                                                                                                                                  |

***

### `nginx`

| Nimi                   | Kuvaus                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `NGINX_ENABLED`        | <p>Kun arvoksi asetetaan <code>true</code>, ohjaa Toolkitin luomaan NGINX-kontin toimimaan TLS-välityspalvelimena.<br><br>- <strong>--continue</strong>: <code>false</code></p>                                                                                                                                                                                                                                                                                                                                                              |
| `NGINX_CONFIG_PATH`    | <p>Polku NGINX:n asetustiedostoon, jota käytetään TLS-välityspalvelimelle.<br><br>- <strong>--continue</strong>: <code>config/nginx/nginx.conf</code></p>                                                                                                                                                                                                                                                                                                                                                                                    |
| `NGINX_TLS_LISTEN_IP`  | <p>Asettaa isäntäkoneen IP-osoitteen(t), joihin TLS-välityspalvelinkontti sitoutuu HTTPS:lle. Esimerkiksi, jos tämä on asetettu arvoon <code>0.0.0.0</code> silloin HTTPS-verkkokäyttöliittymä on saatavilla missä tahansa isäntäkoneen IP-osoitteessa. Yleensä tämän tulisi olla isäntäkoneesi ulkoinen IP-osoite.<br><br>- <strong>--continue</strong>: <code>127.0.1.1</code></p>                                                                                                                                                         |
| `NGINX_HTTP_LISTEN_IP` | <p>Asettaa isäntäkoneen IP-osoitteen(t), joihin TLS-välityspalvelinkontti sitoutuu HTTP-uudelleenohjausta varten. Esimerkiksi, jos tämä on asetettu arvoon <code>127.0.1.1</code> silloin HTTP-yhteydet kohteeseen <code>127.0.1.1</code> ohjataan HTTPS-verkkokäyttöliittymään. Yleensä tämän tulisi olla isäntäkoneesi ulkoinen IP-osoite. Älä aseta sitä arvoon <code>0.0.0.0</code> sillä tämä aiheuttaa yleensä ristiriidan kohteen <code>OVERLEAF\_LISTEN\_IP</code>.<br><br>- <strong>--continue</strong>: <code>127.0.1.1</code></p> |
| `NGINX_HTTP_PORT`      | <p>Asettaa isäntäkoneen portin, johon TLS-välityspalvelinkontti sitoutuu HTTP:lle.<br><br>- <strong>--continue</strong>: <code>80</code></p>                                                                                                                                                                                                                                                                                                                                                                                                 |
| `TLS_PORT`             | <p>Asettaa isäntäkoneen portin, johon TLS-välityspalvelinkontti sitoutuu HTTPS:lle.<br><br>- <strong>--continue</strong>: <code>443</code></p>                                                                                                                                                                                                                                                                                                                                                                                               |
| `TLS_PRIVATE_KEY_PATH` | <p>Polku yksityiseen avaimeen, jota käytetään TLS-välityspalvelimelle.<br><br>- <strong>--continue</strong>: <code>config/nginx/certs/overleaf\_key.pem</code></p>                                                                                                                                                                                                                                                                                                                                                                           |
| `TLS_CERTIFICATE_PATH` | <p>Polku julkiseen varmenteeseen, jota käytetään TLS-välityspalvelimelle.<br><br>- <strong>--continue</strong>: <code>config/nginx/certs/overleaf\_certificate.pem</code></p>                                                                                                                                                                                                                                                                                                                                                                |


---

# 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/toolkit-settings.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.