5. Instanssin mukauttaminen

​

Instanssin mukauttaminen

Ennen kuin käynnistät Overleaf-instanssisi ensimmäistä kertaa, päivitä config/variables.env-määritystiedostoon omat tietosi.

1. Muokkaa muuttujatiedostoa

   Avaa config/variables.env haluamassasi tekstieditorissa ja päivitä alla olevat ympäristömuuttujat tarvittavilla arvoilla.

2. Pakolliset ympäristömuuttujat

   Päivitä seuraavat muuttujat tiedostossa config/variables.env:

   Nimi	Kuvaus	Esimerkki
   OVERLEAF_SITE_URL	Osoite, jossa Overleaf-instanssisi on julkisesti saatavilla. Tätä käytetään julkisissa linkeissä ja websocket-yhteyksissä, joten sen on oltava määritetty oikein!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	Tätä sähköpostiosoitetta käytetään kaikkien lähtevien sähköpostien from-osoitteena.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	Sähköpostiosoite, josta käyttäjät tavoittavat sivuston ylläpitäjän.	[e-mail]

   Kun olet päivittänyt nämä ympäristömuuttujat, tallenna ja sulje tiedosto.

3. Määritä Sandbox Compile

   Määritä seuraavaksi TeX Live Full sandboxed-compiles.md -toimintoa varten. Avaa config/variables.env ja päivitä seuraavat ympäristömuuttujat:

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
4. Käynnistä instanssi

   Käynnistä instanssi ajamalla:

   Start the instance

   bin/up
   

   Tämä komento lataa tarvittavat imaget texlive mukaan lukien, luo kontit (mukautuksiasi käyttäen) ja käynnistää instanssin. Sinun pitäisi nähdä lokitulosteita eri Docker-konteista.

   Kun haluat myöhemmin käynnistää ne uudelleen (liittymättä lokitulosteeseen), aja:

   Start without attaching to logs

   bin/start
   

Toolkit hallitsee Overleafin Docker-kontteja docker compose -työkalulla. Toolkit tarjoaa joukon skriptejä, jotka käärivät docker compose -komennon ja hoitavat useimmat yksityiskohdat puolestasi.

Jos kaikki menee hyvin, näet uuden Overleaf-instanssisi kirjautumissivun siirtymällä selaimessasi osoitteeseen http://127.0.0.1/ tai http://localhost/.

Verkkoasetuksistasi ja Overleaf-instanssisi sijainnista riippuen saatat joutua tekemään lisämäärityksiä. Lisätietoja on Toolkitin asetuksissa: toolkit-settings.md