> 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/asennus/introduction.md).

# Johdanto

Aivan kuten Overleaf Server Pro, Ayakaleaf Pro toimitetaan Docker-säiliönä ja on suora korvaaja, joka sisältää lisäksi ominaisuuksia kuten LDAP:n ja SAML2:n kautta tarjotun SSO:n, parannetun tietoturvan, seuratut muutokset, kommentit, optimoidun TeX Live -version, mallit ja hallintapaneelin.

* Jos et ole koskaan aiemmin ottanut käyttöön mitään Overleaf-versiota, katso [Asenna Docker](/on-premises/fi/asennus/setup-docker.md) asentaaksesi ensin Docker Enginen ja asenna sitten Overleaf [Toolkitin avulla](/on-premises/fi/asennus/using-the-toolkit.md).
* Jos olet jo ottanut käyttöön Overleafin Community Editionin, katso [Siirrä olemassa olevasta](/on-premises/fi/asennus/siirra-olemassa-olevasta.md) siirtyäksesi Ayakaleaf-Prohon.
* Jos olet olemassa oleva Server Pro -käyttäjä, avaa issue ja kerro siitä meille ennen siirtymistä AyakaLeaf Prohon, sillä mallidata on tallennettu hieman eri muodossa.
* Jos kyllästyt joskus AyakaLeaf Prohon ja haluat palata viralliseen Overleaf Community Editioniin, se on täysin tuettu. 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 käytöstä `SERVER_PRO` asetuksen. Kaikki palautuu sitten oletusarvoiseen Community Editioniin.

### Laitteistovaatimukset

* AyakaLeaf Prohon asentamisen vähimmäislaitteistovaatimukset ovat 2-ytiminen CPU ja 3 GB RAM-muistia.
* TeX Live -kuvamme koon vuoksi vähintään 40 GB tallennustilaa vaaditaan hiekkalaatikkokäännöksen käyttöönottoon.
* Jos haluat asentaa koko TeX Live -kuvakokoelman vuosilta 2020–2026, varmista, että käytettävissä on vähintään 150 GB vapaata levytilaa.

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

| Käyttötapaus                                               | Suositeltu kokoonpano                                                                   |
| ---------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Henkilökohtainen käyttö, satunnaisella yhteistyöllä        | 2 CPU-ydintä, 4 GB RAM-muistia                                                          |
| Pienet tiimit, enintään 10 käyttäjää kevyellä yhteistyöllä | 2 CPU-ydintä, 8 GB RAM-muistia                                                          |
| Keskikokoiset tiimit, enintään 100 käyttäjää               | 4 CPU-ydintä, 16 GB RAM-muistia                                                         |
| Suuret käyttöönotot tai yliopistokäytöt                    | Hajautettu klusterikäyttöönotto; ota meihin yhteyttä, jos tarvitset apua käyttöönotossa |

### Ohjelmistovaatimukset

Ohjelmistovaatimusten osalta suosittelemme käyttämään Ubuntu:n tuoretta versiota yhdessä Dockerin uusimman vakaan version kanssa.

Emme suosittele AyakaLeaf Prohon käyttöönottoa Windowsissa tai muissa tuemattomissa käyttöjärjestelmissä, sillä saatat kohdata yhteensopivuusongelmia tai odottamattomia ongelmia asennuksen ja käytön aikana.

### LaTeX-suorituskyky

LaTeX on yksisäikeinen ohjelma, mikä tarkoittaa, että se voi käyttää vain yhtä CPU-ydintä kerrallaan. CPU on myös tärkein rajoite yhtä asiakirjaa käännettäessä. Siksi mitä nopeampi prosessorisi yhden ytimen suorituskyky on, sitä nopeammin pystyt kääntämään asiakirjan. Useammat ytimet auttavat vain, jos yrität kääntää enemmän asiakirjoja kuin sinulla on vapaita CPU-ytimiä.

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

Todellinen käännösnopeus riippuu tietenkin laitteistokokoonpanostasi. Useimmat palvelinprosessorit eivät toimi yhtä korkeilla kellotaajuuksilla kuin 14900K, joten sinun on tehtävä kompromissi kustannusten ja käännösnopeuden välillä.


---

# 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/asennus/introduction.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.
