> 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/environment-variables.md). # Ympäristömuuttujat Tämä sivu kuvaa ympäristömuuttujat, joita tuetaan `config/variables.env` Toolkit-käyttöönottojen tiedostossa. Se `config/variables.env` tiedosto koostuu muuttujamäärityksistä muodossa `NAME=value`; rivit, jotka alkavat merkillä `#` käsitellään kommentteina. {% hint style="info" %} On tarpeen luoda Docker-kontit uudelleen sen jälkeen, kun olet muuttanut mitä tahansa tiedostossa `overleaf.rc` tai `variables.env` suorittamalla `bin/up`. {% endhint %} ### Kaikki versiot Nämä ympäristömuuttujat ovat yhteensopivia Server CE:n ja Server Pron kanssa, ja ne tarjoavat helpon siirtymäpolun näiden kahden paikallisen version välillä. Niitä voidaan käyttää myös sekä Toolkit- että Docker Compose -käyttöönottojen kanssa. {% hint style="info" %} Aiemmin näiden ympäristömuuttujien etuliite oli `SHARELATEX_` eikä `OVERLEAF_`. {% endhint %} | Nimi | Kuvaus | | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `OVERLEAF_SITE_URL` | Missä Overleaf-instanssisi on julkisesti saatavilla. Tätä käytetään julkisissa linkeissä ja muodostettaessa yhteyttä websokettien kautta, joten se on määritettävä oikein! | | `OVERLEAF_ADMIN_EMAIL` | Sähköpostiosoite, jonka kautta käyttäjät voivat ottaa yhteyttä sivustoa ylläpitävään henkilöön. | | `OVERLEAF_APP_NAME` | Nimi, joka näytetään puhuttaessa käynnissä olevasta sovelluksesta. Oletus on 'Overleaf (Community Edition)'. | | `OVERLEAF_MONGO_URL` ja `MONGO_URL` | Käytettävän Mongo-tietokannan URL-osoite. | | `OVERLEAF_REDIS_HOST` ja `REDIS_HOST` | Käytettävän Redis-instanssin isäntänimi. Molemmat vaaditaan (katso [julkaisutiedot](broken://pages/442e912a6e436094b5a6dc7e2a1c2df6dc847b10#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PORT` ja `REDIS_PORT` | Käytettävän Redis-instanssin portti. Molemmat vaaditaan (katso [julkaisutiedot](broken://pages/442e912a6e436094b5a6dc7e2a1c2df6dc847b10#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PASS` ja `REDIS_PASSWORD` | Salasana, jota käytetään muodostettaessa yhteyttä Redis-palvelimeen (jos sovellettavissa). **Molemmat** ympäristömuuttujat on asetettava. Katso [salasanatodennuksen käyttöönotto](broken://pages/d0ecddd8fbf5c5002d73c1ecbbfcc4448aad8657) lisätietoja varten. | | `OVERLEAF_REDIS_TLS` |

Jos asetetaan arvoksi true, sallii yhteyden muodostamisen Redis-instanssiin, joka vaatii TLS:ää.

Huom: mTLS:ää ei tällä hetkellä tueta.

| | `OVERLEAF_NAV_TITLE` | Aseta sovelluksen välilehden otsikko. | | `OVERLEAF_INVITE_TOKEN_SECRET` |

Vaaditaan. Satunnainen merkkijono, jota käytetään projektin jakamistunnusten suojaamiseen (lisätty Server Pro 6.2.0:ssa).

Merkkien vähimmäismäärä: 16

| | `OVERLEAF_SESSION_SECRET` | Satunnainen merkkijono, jota käytetään tunnusten suojaamiseen; jos käytössä on kuormantasaus, tämä on asetettava samaksi tunnukseksi kaikilla palvelimilla. Jos ajetaan vain yhtä instanssia, käyttäjän ei tarvitse asettaa sitä. | | `OVERLEAF_COOKIE_SESSION_LENGTH` | Voit ohittaa oletusarvoisen istuntoevästeen vanhenemisajan, joka on 5 päivää. Ohjearvon tulee olla millisekunteina. Esimerkki: jos haluat istunnon kestävän 1 tunnin, aseta `COOKIE_SESSION_LENGTH=3600000`. (Lisätty Server Pro 4.2:ssa) | | `OVERLEAF_TRUSTED_PROXY_IPS` |

Jos ei aseteta, oletusarvo on loopback. Jos asetat manuaalisesti, luotettujen IP-osoitteidesi lisäksi sinun on sisällytettävä myös jokin arvoista loopback, localhost tai 127.0.0.1, joka luottaa nginx-instanssiin, joka toimii sharelatex kontissa.

Jos käytät aliverkkoa 172.16.0.0/12 (Docker-verkojen oletusaliverkko) tavalliselle verkollesi, aseta OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\ tiedostossasi config/variables.env. Missä \ on IPAM -> Config -> Subnet arvo tiedostossa docker inspect overleaf\_default, esim. OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,172.19.0.0/16. Tämä estää X-Forwarded otsakkeiden väärentämisen.

Jos käytät ulkoista TLS-välityspalvelinta (eli Overleaf Toolkit ei hallinnoi sitä), varmista että OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,\, esim. OVERLEAF\_TRUSTED\_PROXY\_IPS=loopback,192.168.13.37.

| | `OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS` | Jos asetetaan arvoksi `true`, rajoittaa projektikutsut sähköpostiosoitteisiin, jotka vastaavat olemassa olevia käyttäjätilejä. | | `OVERLEAF_ALLOW_PUBLIC_ACCESS` | Jos asetetaan arvoksi `true`, sallii vahvistamattomien käyttäjien tarkastella sivustoa. Oletusarvo on `false`, mikä tarkoittaa, että vahvistamattomat käyttäjät ohjataan ehdoitta kirjautumissivulle, kun he yrittävät tarkastella sivuston mitä tahansa osaa. Huomaa, että tämän asetuksen käyttäminen ei poista todennusta tai turvallisuutta millään tavalla. Tämä asetus on tarpeen, jos käyttäjäsi aikovat tehdä projekteistaan julkisia ja antaa vahvistamattomien käyttäjien tarkastella niitä. | | `OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` | Jos asetetaan arvoksi `true`, sallii anonyymien käyttäjien tarkastella ja muokata projekteja, jotka on jaettu [linkinjakamisen](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) ominaisuuden kautta. | | `OVERLEAF_DISABLE_LINK_SHARING` | Poistaa käytöstä [linkinjakamisen](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) ominaisuuden kautta. | | `EMAIL_CONFIRMATION_DISABLED` | Kun asetetaan arvoksi `true` vahvistusviestiä pyytävää banneria ei näytetä. | | `ADDITIONAL_TEXT_EXTENSIONS` | Merkkijonoista koostuva taulukko, jolla määritetään muokattavien tiedostojen lisäpääteet. | | `DEFAULT_LATEX_COMPILER` |

Käytetään asettamaan oletuskääntäjä, jota uudet projektit käyttävät. (Lisätty Server Pro 6.2.0:ssa).

Vaihtoehdot: pdflatex, latex, xelatex tai lualatex

| | `OVERLEAF_STATUS_PAGE_URL` | Mukautettu tilasivun URL-osoite (lisätty Server Pro 3.4.0:ssa), esim. `status.example.com`. | | `OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS` | Aseta arvoksi `'false'` estääksesi uusia projekteja alustumasta Full Project Historylla (lisätty Server Pro 3.5.0:ssa). | | `OVERLEAF_FPH_DISPLAY_NEW_PROJECTS` | Aseta arvoksi `'false'` estääksesi uusia projekteja näyttämästä Full Project Historya perinteisen historian sijasta (lisätty Server Pro 3.5.0:ssa). | | `ENABLE_CRON_RESOURCE_DELETION` | Aseta tämä ympäristömuuttuja arvoksi `true` ottaaksesi käyttöön poistettujen projektien ja käyttäjien automaattisen siivouksen 90 päivän jälkeen. | | `OVERLEAF_USER_HARD_DELETION_DELAY` |

Käytetään poistettujen käyttäjien vanhenemisviiveen muuttamiseen. Määritetään millisekunteina.

Oletus: 90 päivää

| | `OVERLEAF_PROJECT_HARD_DELETION_DELAY` |

Käytetään poistettujen projektien vanhenemisviiveen muuttamiseen. Määritetään millisekunteina.

Oletus: 90 päivää

| | `MAX_UPLOAD_SIZE` |

Ohjaa yksittäisen latauksen enimmäiskokoa megatavuina. Oletusarvo on 50.

Huomio: Tämä muuttuja on pelkkä raakaluku ilman yksikköä (MB) tai ympäröivää merkintää.

| | `COMPILE_SIZE_LIMIT` | Ohjaa pyynnön rungon enimmäiskokoa tavuina. Tämä on kaikkien projektin doc-tiedostojen kokojen summa (`main.tex`, `references.bib` (jos ei linkitetty) jne.), joka on lähetettävä ensimmäisessä käännöspyynnössä CLSI-palvelulle. | | `COMPILE_TIMEOUT` | Käännöksen valmistumiseen sallittu aika sekunneissa. Lisätietoja: [Projektin käännöksen aikakatkaisun päivittäminen](broken://pages/68cb9a876ccdf570efcaf525e75a582144d6e815#updating-project-compile-timeout). | | `MAX_RECONNECT_GRACEFULLY_INTERVAL_MS` | Säädettävä viive editorin hallitun uudelleenyhdistämisen, datan tyhjennyksen ja konttien sammutuksen välillä tietojen menetyksen riskin pienentämiseksi. | | `SECCOMP_PROFILE` |

Aseta tämä ympäristömuuttuja polkuun Dockerin isäntäkoneella joka osoittaa SECCOMP-profiiliin. Voit ladata profiilin kopion täältä.

Tarvitaan tällä hetkellä Podman-käyttöönottoissa, kun käytetään eristettyjä käännöksiä.

| | `OVERLEAF_DISABLE_CHAT` | Jos asetetaan arvoksi `true`, poistaa käytöstä projektin sisäisen chat-ominaisuuden. | | `OVERLEAF_LOGIN_SUPPORT_TEXT` | Kun asetettu, sitä voidaan käyttää tukitietojen näyttämiseen kirjautumispainikkeen alapuolella. Teksti näytetään kirjautumisnäytössä, ja sitä voidaan käyttää ohjaamaan käyttäjiä sisäiseen tukeen tai antamaan kirjautumiseen, tilin luomiseen jne. liittyviä ohjeita. | | `ALLOW_MONGO_ADMIN_CHECK_FAILURES` |

Jos asetetaan arvoksi true, sallii MongoDB:n käynnistystarkistusten epäonnistua eikä estä käyttöönoton käynnistymistä. Tämä voi olla tarpeen, jos käytät MongoDB-tietokantaa, jossa tietokantasi käyttäjällä ei ole clusterParameterReader roolia.

Ohjeita mukautetun roolin luomiseen: täältä.

| | `V1_HISTORY_URL_FOR_GIT_BRIDGE` | Mahdollistaa erottamisen **history-v1** päätepisteen sisäiselle liikenteelle (`web` palvelu → `history-v1` palvelu, molemmat `sharelatex` kontissa) ja ulkoiselle liikenteelle (`git-bridge` → `history-v1`, jotka toimivat erillisissä konteissa). | | `OVERLEAF_MAINTENANCE_MESSAGE` ja `OVERLEAF_MAINTENANCE_MESSAGE_HTML` | Käytetään Huoltosivun otsikon ja sisällön mukauttamiseen. Ei voi käyttää yhdessä `OVERLEAF_STATUS_PAGE_URL`. | {% hint style="info" %} Käyttäjille on mahdollista pakottaa salasanarajoituksia käytettäessä Overleafin kirjautumisjärjestelmää (paikalliset tilit), ei SSO-vaihtoehtoa, kuten LDAP. SSO-tileillä salasanakäytännöt pakottaa identiteetin tarjoajasi tai hakemistopalvelusi, ja ne tukevat lisäksi monivaiheista todennusta. {% endhint %} --- # 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/environment-variables.md?ask=&goal= ``` `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.