> 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/environment-variables.md). # Ympäristömuuttujat Tämä sivu kuvaa ympäristömuuttujat, joita tuetaan `config/variables.env` Toolkit-käyttöönottojen tiedostossa. Kentän `config/variables.env` tiedosto koostuu muuttujamäärityksistä muodossa `NAME=value`; rivit, jotka alkavat `#` 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 %} ### 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 etuliitteenä oli `SHARELATEX_` sen sijaan että `OVERLEAF_`. {% endhint %} | Nimi | Kuvaus | | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `OVERLEAF_SITE_URL` | Missä Overleaf-instanssisi on julkisesti saatavilla. Tätä käytetään julkisissa linkeissä ja websocket-yhteyksissä, joten se on määritettävä oikein! | | `OVERLEAF_ADMIN_EMAIL` | Sähköpostiosoite, josta käyttäjät tavoittavat sivustoa ylläpitävän henkilön. | | `OVERLEAF_APP_NAME` | Käynnissä olevaa sovellusta kuvattaessa näytettävä nimi. Oletuksena 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. Molempia tarvitaan (katso [julkaisumuistiinpanot](broken://pages/442e912a6e436094b5a6dc7e2a1c2df6dc847b10#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PORT` ja `REDIS_PORT` | Käytettävän Redis-instanssin portti. Molempia tarvitaan (katso [julkaisumuistiinpanot](broken://pages/442e912a6e436094b5a6dc7e2a1c2df6dc847b10#changes-to-the-docker-compose-file-format)). | | `OVERLEAF_REDIS_PASS` ja `REDIS_PASSWORD` | Redis-yhteyden muodostamiseen käytettävä salasana (jos sovellettavissa). **Molemmat** ympäristömuuttujat on asetettava. Katso [salasanatodennuksen käyttöönotto](broken://pages/d0ecddd8fbf5c5002d73c1ecbbfcc4448aad8657) lisätietoja varten. | | `OVERLEAF_REDIS_TLS` |

Jos arvoksi asetetaan true, mahdollistaa yhteyden TLS:ää vaativaan Redis-instanssiin.

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

| | `OVERLEAF_NAV_TITLE` | Aseta sovelluksen välilehden otsikko. | | `OVERLEAF_SESSION_SECRET` | Satunnainen merkkijono, jota käytetään tokenien suojaamiseen; jos käytössä on kuormantasaus, tämän on oltava sama kaikissa solmuissa. Jos käytössä on vain yksi instanssi, käyttäjän ei tarvitse asettaa sitä. | | `OVERLEAF_COOKIE_SESSION_LENGTH` | Voit ohittaa oletusarvoisen istuntoevästeen voimassaoloajan, joka on 5 päivää. Korvausarvon tulee olla millisekunteina. Esimerkki: jos haluat istunnon kestävän 1 tunnin, aseta `COOKIE_SESSION_LENGTH=3600000`. (Lisätty Server Prohon 4.2:ssa) | | `OVERLEAF_TRUSTED_PROXY_IPS` |

Jos sitä ei ole asetettu, oletusarvo on loopback. Jos asetat sen manuaalisesti, luotettujen IP-osoitteidesi lisäksi sinun on sisällytettävä myös yksi seuraavista: loopback, localhost tai 127.0.0.1, joka luottaa nginx-instanssiin, joka toimii sharelatex kontin sisällä.

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

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 arvoksi asetetaan `true`, rajoittaa projektikutsuja sähköpostiosoitteisiin, jotka vastaavat olemassa olevia käyttäjätilejä. | | `OVERLEAF_ALLOW_PUBLIC_ACCESS` | Jos arvoksi asetetaan `true`, sallii kirjautumattomien käyttäjien tarkastella sivustoa. Oletusarvo on `false`, mikä tarkoittaa, että kirjautumattomat käyttäjät ohjataan ehdottomasti kirjautumissivulle, kun he yrittävät tarkastella mitä tahansa sivuston osaa. Huomaa, että tämän asetuksen määrittäminen ei poista todennusta tai tietoturvaa millään tavalla. Tämä asetus on tarpeen, jos käyttäjäsi aikovat tehdä projekteistaan julkisia ja sallia kirjautumattomien käyttäjien tarkastella niitä. | | `OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` | Jos arvoksi asetetaan `true`, sallii anonyymien käyttäjien tarkastella ja muokata projekteja, jotka on jaettu [linkinjaon](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) ominaisuuden kautta. | | `OVERLEAF_DISABLE_LINK_SHARING` | Poistaa käytöstä [linkinjaon](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27) ominaisuuden kautta. | | `EMAIL_CONFIRMATION_DISABLED` | Kun arvoksi asetetaan `true` sähköpostivahvistusta pyytävää banneria ei näytetä. | | `ADDITIONAL_TEXT_EXTENSIONS` | Merkkijonotaulukko, jolla määritetään muokattavien tiedostojen lisätunnisteet. | | `OVERLEAF_STATUS_PAGE_URL` | Mukautetun tilasivun URL-osoite (lisätty Server Prohon 3.4.0:ssa), esim. `status.example.com`. | | `OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS` | Aseta arvoksi `'false'` jotta uusia projekteja ei alusteta Full Project Historylla (lisätty Server Prohon 3.5.0:ssa). | | `OVERLEAF_FPH_DISPLAY_NEW_PROJECTS` | Aseta arvoksi `'false'` jotta uudet projektit eivät näytä Full Project Historya vanhan historian sijaan (lisätty Server Prohon 3.5.0:ssa). | | `ENABLE_CRON_RESOURCE_DELETION` | Aseta tämän ympäristömuuttujan arvoksi `true` otta poistettujen projektien ja käyttäjien automaattinen siivous otetaan käyttöön 90 päivän kuluttua. | | `OVERLEAF_USER_HARD_DELETION_DELAY` |

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

Oletukset: 90 päivää

| | `OVERLEAF_PROJECT_HARD_DELETION_DELAY` |

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

Oletukset: 90 päivää

| | `MAX_UPLOAD_SIZE` |

Määrittää yksittäisen latauksen enimmäiskoon megatavuina. Oletusarvo on 50.

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

| | `COMPILE_SIZE_LIMIT` | Määrittää pyynnön rungon enimmäiskoon tavuina. Tämä on kaikkien projektin doc-tiedostojen kokojen summa (`main.tex`, `references.bib` (jos ei ole linkitetty) jne.), joka on lähetettävä CLSI-palvelun alkuperäisessä käännöspyynnössä. | | `COMPILE_TIMEOUT` | Käännöksen valmistumiseen sallittu aika sekunteina. Lisätietoja on kohdassa [Projektin käännöksen aikakatkaisun päivittäminen](broken://pages/68cb9a876ccdf570efcaf525e75a582144d6e815#updating-project-compile-timeout). | | `MAX_RECONNECT_GRACEFULLY_INTERVAL_MS` | Määritettävä viive editorin hallitun uudelleenyhdistämisen, tietojen tyhjennyksen ja kontin sammutuksen välillä tietojen katoamisen riskin pienentämiseksi. | | `SECCOMP_PROFILE` |

Aseta tämän ympäristömuuttujan arvoksi polku Dockerin isäntä kone, joka osoittaa SECCOMP-profiiliin. Voit ladata kopion profiilista täältä.

Tarvitaan tällä hetkellä Podman-käyttöönottoihin, kun käytetään Sandboxed Compiles -toimintoa.

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

Jos arvoksi asetetaan 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 tietokantakäyttäjälläsi ei ole clusterParameterReader roolia.

Ohjeita mukautetun roolin luomiseen on kohdassa täältä.

| | `V1_HISTORY_URL_FOR_GIT_BRIDGE` | Mahdollistaa **history-v1** päätepisteen erottamisen sisäiselle liikenteelle (`web` palvelu → `history-v1` palvelu, sekä `sharelatex` kontissa) ja ulkoiselle liikenteelle (`git-bridge` → `history-v1`, jotka toimivat erillisissä konteissa). | | `OVERLEAF_MAINTENANCE_MESSAGE` ja `OVERLEAF_MAINTENANCE_MESSAGE_HTML` | Käytetään ylläpitosivun otsikon ja sisällön mukauttamiseen. Ei voi käyttää yhdessä `OVERLEAF_STATUS_PAGE_URL`. | {% hint style="info" %} Salasanojen rajoitukset voidaan pakottaa käyttäjille, kun käytetään Overleafin kirjautumisjärjestelmää (paikalliset tilit), ei SSO-vaihtoehtoa kuten LDAP:ia. SSO-tileillä salasanakäytännöt pakottaa identiteetin tarjoajasi tai hakemistopalvelusi, ja ne voivat lisäksi tukea 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://overleaf-pro.ayaka.space/on-premises/fi/maaritys/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.