> 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/yllapito/docker-compose.yml-to-toolkit-migration.md).

# Siirtyminen docker-compose.yml:stä Toolkitiin

Jos käytät tällä hetkellä Docker Composea kautta `docker-compose.yml` tiedoston kautta, siirtyminen Toolkitiin voi tehdä Overleafin paikallisen version käyttöönotosta, päivittämisestä ja ylläpidosta helpompaa.

Siirtyäksesi sinun täytyy muuntaa nykyinen Docker Compose -asetuksesi Toolkitin käyttämään muotoon. Tämä prosessi sisältää olemassa olevan määrityksen kopioimisen Toolkittiin.

Tämä opas käy läpi jokaisen vaiheen tässä prosessissa ja varmistaa sujuvan siirtymisen Docker Composesta Toolkitiin.

{% hint style="info" %}
Nämä ohjeet koskevat versiota v4.x ja aiempia. Siksi kaikki muuttujat käyttävät `SHARELATEX_` etuliite sen sijaan `OVERLEAF_`.
{% endhint %}

{% stepper %}
{% step %}

### Kloonaa Toolkitin repositorio

Kloonaa ensin Toolkitin repositorio isäntäkoneelle:

```bash
git clone https://github.com/overleaf/toolkit.git ./overleaf-toolkit
```

Suorita seuraavaksi `bin/init` komento alustamaan Toolkit sen oletusmäärityksillä.
{% endstep %}

{% step %}

### Kuvan ja version määrittäminen

Tyypillisessä `docker-compose.yml` kuva ja versio määritetään komponentin kuvauksessa, esimerkiksi:

```yaml
version: '2.2'
services:
    sharelatex:
        restart: always
        # Server Pro -käyttäjät:
        # image: quay.io/sharelatex/sharelatex-pro
        image: sharelatex/sharelatex:3.5.13
```

Toolkitia käytettäessä kuvan nimi ratkaistaan automaattisesti; ainoa vaatimus on asettaa `SERVER_PRO=true` tiedostossa **config/overleaf.rc** jotta valitaan Server Pro -kuva tai `SERVER_PRO=false` jotta käytetään Community Editionia.

Haluttu Server Pro/Community Edition -versionumero asetetaan **config/version** tiedostossa. Toolkit vaatii tietyn versionumeron, kuten `4.2.3`. Jos käytät `latest`, voit käyttää `bin/images` löytääksesi paikallisen `latest` version kuvan tunnuksen, ja käytä sitten versioiden 2.x.x, 3.x.x, 4.x.x tai 5.x.x julkaisutietoja kuvatunnuksen yhdistämiseksi versioon.

Jos hankit kuvan omasta sisäisestä rekisteristäsi, voit ohittaa Toolkitin käyttämän kuvan asettamalla `OVERLEAF_IMAGE_NAME`. Sinun ei tarvitse määrittää tagia, sillä Toolkit lisää sen automaattisesti perustuen **config/version** tiedostoon.
{% endstep %}

{% step %}

### Ulkoisen käytön määrittäminen

Oletusarvoisesti Overleaf kuuntelee osoitteessa `127.0.0.1:80`, salliessaan liikenteen vain Docker-isäntäkoneelta.

Salliaksesi ulkoisen käytön, aseta `OVERLEAF_LISTEN_IP` ja `OVERLEAF_PORT` tiedostossa [**config/overleaf.rc**](/on-premises/fi/konfiguraatio/overleaf-toolkit/environment-variables.md) tiedostoon.
{% endstep %}

{% step %}

### Ympäristömuuttujien siirtäminen

Sinulla on todennäköisesti joukko ympäristömuuttujia määritettynä `sharelatex` palvelussa sinun `docker-compose.yml`, esimerkiksi:

```yaml
environment:
    OVERLEAF_APP_NAME: Overleaf Community Edition
    OVERLEAF_PROXY_LEARN: 'true'
    …
```

Kopioi nämä muuttujat Toolkitin [**config/variables.env**](broken://pages/21973f574b41e6ba323df98d218222a9b2512364) tiedostoon varmistaen seuraavan muodon (käytä `=` eikä `:`):

```env
OVERLEAF_APP_NAME=Overleaf Community Edition
OVERLEAF_PROXY_LEARN=true
```

Poikkeukset / erot Toolkitia käytettäessä:

* Muuttujat, jotka alkavat `SANDBOXED_COMPILES_` ja `DOCKER_RUNNER` eivät ole enää tarpeen. Ota Sandboxed Compiles käyttöön asettamalla `SIBLING_CONTAINERS_ENABLED=true` tiedostossasi **config/overleaf.rc** tiedostoon.
* Muuttujat, jotka alkavat `OVERLEAF_MONGO_`, `OVERLEAF_REDIS_` että `REDIS_HOST` muuttujaa ei enää tarvita. MongoDB ja Redis määritetään nyt **config/overleaf.rc** tiedostossa käyttäen `MONGO_URL`, `REDIS_HOST` ja `REDIS_PORT`.

Lisäasetusten määrittämistä varten katso [config/overleaf.rc](/on-premises/fi/konfiguraatio/overleaf-toolkit/environment-variables.md) dokumentaatiota.
{% endstep %}

{% step %}

### NGINX-välityspalvelin

Ohjeet siirtämiseen `nginx`, katso [TLS-välityspalvelimen dokumentaatio](/on-premises/fi/konfiguraatio/overleaf-toolkit/tls-proxy.md):
{% endstep %}

{% step %}

### Taltiot

Määritä datataltioden sijainnit **config/overleaf.rc**:

#### ShareLaTeX

Aseta `OVERLEAF_DATA_PATH` datataltion sijainniksi, jota käyttää `sharelatex` kontissa.

#### MongoDB

Aseta `MONGO_DATA_PATH` datataltion sijainniksi, jota käyttää `mongo` kontissa.

#### Redis

Aseta `REDIS_DATA_PATH` datataltion sijainniksi, jota käyttää `redis` kontissa.
{% endstep %}
{% endstepper %}

Lisätietoja ja lisämäärityksiä varten katso yllä linkitettyjä Toolkitin määritysdokumentteja.


---

# 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/yllapito/docker-compose.yml-to-toolkit-migration.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.