> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Johdanto

> Ota Ayakaleaf Pro käyttöön siirtoa, vaatimuksia ja LaTeX-suorituskykyä koskevien ohjeiden avulla.

Overleaf Server Pron tavoin Ayakaleaf Pro toimitetaan Docker-konttina, ja se on suora korvaaja, joka sisältää lisäksi ominaisuuksia, kuten LDAP:n ja SAML2:n kautta toteutetun SSO:n, parannetun tietoturvan, muutosten seurannan, kommentit, optimoidun TeX Live -versiomme, mallipohjat ja hallintapaneelin.

* Jos haluat vain testata Ayakaleaf Pron ominaisuuksia tai kokeilla demoa, voit seurata [using-the-github-codespace.md](/fi/on-premises/installation/using-the-github-codespace "mention") -opasta. Demoympäristö käyttää minimaalista TeX Live -asennusta, joten osa projekteistasi ei välttämättä käänny onnistuneesti.
* Jos et ole koskaan aiemmin ottanut käyttöön mitään Overleafin versiota, asenna ensin Docker Engine [Setup Docker](/fi/on-premises/installation/setup-docker) -ohjeen mukaisesti ja asenna sitten Overleaf [using-the-toolkit](/fi/on-premises/installation/using-the-toolkit "mention") -ohjeen avulla.
* Jos olet jo ottanut käyttöön Overleafin Community Editionin, katso [migrate-from-existing.md](/fi/on-premises/installation/migrate-from-existing "mention") siirtyäksesi Ayakaleaf Prohon.
* Jos käytät mieluummin agentteja, kuten Claudea tai Codexia, katso: [using-claude-or-codex.md](/fi/on-premises/installation/using-claude-or-codex "mention").
* Jos sinun on otettava ohjelmisto käyttöön offline- tai eristetyssä ympäristössä, katso: [air-gapped-offline-deployments.md](/fi/on-premises/installation/air-gapped-offline-deployments "mention").
* Jos olet nykyinen Server Pron käyttäjä, avaa issue ja kerro meille ennen siirtymistä Ayakaleaf Prohon, sillä mallitiedot tallennetaan hieman eri muodossa. Autamme mielellämme siirtymisessä Server Prosta Ayakaleaf Prohon maksutta.
* Jos joskus kyllästyt Ayakaleaf Prohon ja haluat palata viralliseen Overleaf Community Editioniin, se on täysin tuettua. Mitään tietojasi ei menetetä. Virallisen Overleaf Toolkitin käyttäjät voivat yksinkertaisesti poistaa override-YAML-tiedostonsa. ayaka-notes-toolkitin käyttäjät voivat poistaa `SERVER_PRO`-asetuksen käytöstä. Tämän jälkeen kaikki palaa tavalliseen Community Editioniin.

Valitse asennustapa tarpeidesi mukaan:

<Card title="GitHub Codespacen käyttäminen" icon="file-lines" href="/fi/on-premises/installation/using-the-github-codespace" horizontal />

<Card title="Toolkitin käyttäminen" icon="file-lines" href="/fi/on-premises/installation/using-the-toolkit" horizontal />

<Card title="Clauden tai Codexin käyttäminen" icon="file-lines" href="/fi/on-premises/installation/using-claude-or-codex" horizontal />

<Card title="Eristetyt/offline-käyttöönotot" icon="file-lines" href="/fi/on-premises/installation/air-gapped-offline-deployments" horizontal />

<Card title="Siirtyminen olemassa olevasta asennuksesta" icon="file-lines" href="/fi/on-premises/installation/migrate-from-existing" horizontal />

### Laitteistovaatimukset

Teimme asiaankuuluvia testejä ja havaitsimme, että kun Overleafia ajetaan palvelimella, jossa on 2 ydintä ja 2 Gt RAM-muistia, sen pääosin Node.js-pohjaiset ydinkomponentit kuluttavat noin 1 Gt muistia. Redis ja MongoDB voivat vaatia lisäksi 0,5 Gt, ja hiekkalaatikoidun Docker-kontin käynnistäminen käännöstä varten voi kuluttaa vielä 0,3 Gt. Tämä tarkoittaa, että 2-ytiminen 2 Gt:n palvelin pystyy realistisesti käsittelemään vain noin yhden samanaikaisen käännöksen kerrallaan.

* Ayakaleaf Pron asennuksen vähimmäislaitteistovaatimukset ovat 2-ytiminen suoritin ja 3 Gt RAM-muistia.
* TeX Live -imagemme koon vuoksi hiekkalaatikoidun käännöksen käyttöönotto vaatii vähintään 40 Gt tallennustilaa.
* Jos haluat asentaa kaikki TeX Live -imaget vuosilta 2020–2026, varmista, että vapaata levytilaa on vähintään 150 Gt.

Tässä on joitakin suositeltuja laitteistokokoonpanoja eri käyttötilanteisiin:

| Käyttötapaus | Suositeltu kokoonpano |
| - | - |
| Henkilökohtainen käyttö satunnaisella yhteistyöllä | 2 suoritinydintä, 4 Gt RAM, 80 Gt tallennustilaa |
| Pienet tiimit, enintään 10 käyttäjää kevyellä yhteistyöllä | 2 suoritinydintä, 8 Gt RAM, 256 Gt tallennustilaa |
| Keskikokoiset tiimit, enintään 100 käyttäjää | 4 suoritinydintä, 16 Gt RAM, 1 Tt tallennustilaa |
| Laajamittaiset tai yliopistotason käyttöönotot | Hajautettu klusterikäyttöönotto S3-tallennuksella; ota meihin yhteyttä, jos tarvitset apua käyttöönotossa |

### Ohjelmistovaatimukset

Ohjelmistojen osalta suosittelemme käyttämään tuoretta ja vakaata Ubuntu-versiota (esim. Ubuntu 24.04 vuosina 2025–2026, Ubuntu 22.04 vuosina 2023–2024) yhdessä Dockerin uusimman vakaan version kanssa.

<Info>
  Vakaus ennen kaikkea: valitse uusin Ubuntu LTS, joka on ollut saatavilla jo jonkin aikaa, eikä juuri julkaistua versiota. Esimerkiksi lokakuussa 2026 Ubuntu 26.04 ei ole tuettu: sen mukana tulee Linux-ydin 7.0, eikä MongoDB käynnisty Linux-ytimillä 6.19–7.0.13 ([lisätietoja](https://www.mongodb.com/docs/manual/administration/production-notes/)), joten käytä Ubuntu 24.04:ää.
</Info>

Emme suosittele Ayakaleaf Pron käyttöönottoa Windowsissa tai muissa tukemattomissa käyttöjärjestelmissä, kuten CentOS:ssä, sillä saatat kohdata yhteensopivuusongelmia tai odottamattomia ongelmia asennuksen ja käytön aikana.

Jos kuitenkin haluat kokeilla Ayakaleaf Pron käyttöönottoa ARM-pohjaisissa järjestelmissä tai macOS:ssä, olet tervetullut jakamaan kokemuksiasi ja palautettasi yhteisön kanssa.

### LaTeXin suorituskyky

LaTeX on yksisäikeinen ohjelma, eli se voi käyttää vain yhtä suoritinydintä kerrallaan. Yksittäistä asiakirjaa käännettäessä suorituskykyä rajoittaa ensisijaisesti suorittimen yhden ytimen kellotaajuus. Mitä nopeampi suorittimesi yhden ytimen suorituskyky on, sitä nopeammin voit kääntää asiakirjan. Useammista suoritinytimistä on hyötyä vain, kun useat käyttäjät kääntävät asiakirjoja samanaikaisesti.

Esimerkiksi [ThuThesis-mallilla](https://www.overleaf.com/latex/templates/thuthesis-tsinghua-university-thesis-latex-template/cfwgcxtvkbsx) käännösaika on noin 6 sekuntia Intel Core i9-14900K -suorittimella (5,6 GHz), kun taas AMD EPYC 7763 -suorittimella (3,2 GHz) toimivalla Azure Standard D2as v5 -instanssilla (2 vCPU:ta, 8 GiB RAM) se kestää noin 13 sekuntia.

Todellinen käännössuorituskyky riippuu tietenkin laitteistokokoonpanostasi. Useimmat palvelinsuorittimet eivät toimi yhtä korkeilla kellotaajuuksilla kuin 14900K, joten joudut tasapainoilemaan kustannusten ja käännösnopeuden välillä.

Olemme myös analysoineet LaTeX-käännösten suorituskykyä perusteellisesti. Jos aihe kiinnostaa, lue blogikirjoituksemme [Overleaf Benchmark: A Deep Research of Concurrent LaTeX Compilation in Overleaf (SaaS and Self-host)](/fi/blog/2026/overleaf-benchmark "mention").


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.