> 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/on-premises-cs/udrzba/docker-compose.yml-to-toolkit-migration.md).

# Migrace z docker-compose.yml do Toolkitu

Pokud v současné době používáte Docker Compose prostřednictvím `docker-compose.yml` souboru, migrace na Toolkit může usnadnit nasazení, aktualizaci a údržbu lokální verze Overleafu.

Pro migraci budete muset převést stávající nastavení Docker Compose do formátu používaného Toolkitem. Tento proces zahrnuje zkopírování stávající konfigurace do Toolkitu.

Tato příručka vás provede jednotlivými kroky tohoto procesu a zajistí hladkou migraci z Docker Compose na Toolkit.

{% hint style="info" %}
Tyto pokyny jsou určeny pro verzi 4.x a starší. Proto všechny proměnné používají `SHARELATEX_` předponu místo `OVERLEAF_`.
{% endhint %}

{% stepper %}
{% step %}

### Naklonování repozitáře Toolkitu

Nejprve naklonujte repozitář Toolkitu do hostitelského počítače:

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

Poté spusťte `bin/init` příkaz k inicializaci Toolkitu s jeho výchozí konfigurací.
{% endstep %}

{% step %}

### Nastavení obrazu a verze

V typickém `docker-compose.yml` obraz a verze jsou definovány v popisu komponenty, například:

```yaml
version: '2.2'
services:
    sharelatex:
        restart: always
        # Uživatelé Server Pro:
        # image: quay.io/sharelatex/sharelatex-pro
        image: sharelatex/sharelatex:3.5.13
```

Při používání Toolkitu se název obrazu určí automaticky; jediným požadavkem je nastavit `SERVER_PRO=true` v **config/overleaf.rc** pro výběr obrazu Server Pro nebo `SERVER_PRO=false` pro použití Community Edition.

Požadované číslo verze Server Pro/Community Edition se nastavuje v **config/version** souboru. Toolkit vyžaduje konkrétní číslo verze, například `4.2.3`. Pokud používáte `latest`, můžete použít `bin/images` k nalezení ID obrazu vaší lokální `latest` verze a poté pomocí poznámek k vydání pro 2.x.x, 3.x.x, 4.x.x nebo 5.x.x přiřaďte ID obrazu k verzi.

Pokud získáváte obraz z vlastního interního registru, můžete přepsat obraz používaný Toolkitem nastavením `OVERLEAF_IMAGE_NAME`. Značku nemusíte zadávat, protože Toolkit ji automaticky přidá na základě vašeho **config/version** soubor.
{% endstep %}

{% step %}

### Konfigurace externího přístupu

Ve výchozím nastavení bude Overleaf naslouchat na `127.0.0.1:80`, což umožňuje provoz pouze z hostitelského počítače Dockeru.

Chcete-li povolit externí přístup, nastavte `OVERLEAF_LISTEN_IP` a `OVERLEAF_PORT` v [**config/overleaf.rc**](/on-premises/on-premises-cs/konfigurace/overleaf-toolkit/environment-variables.md) soubor.
{% endstep %}

{% step %}

### Migrace proměnných prostředí

Pravděpodobně máte sadu proměnných prostředí definovaných ve službě `sharelatex` ve vašem `docker-compose.yml`, například:

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

Zkopírujte tyto proměnné do [**config/variables.env**](broken://pages/7032811494e0197360851b99088110b0a3cd1079) souboru Toolkitu a zajistěte následující formát (použijte `=` namísto `:`):

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

Výjimky / rozdíly při používání Toolkitu:

* Proměnné začínající na `SANDBOXED_COMPILES_` a `DOCKER_RUNNER` již nejsou potřeba. Chcete-li povolit Sandboxed Compiles, nastavte `SIBLING_CONTAINERS_ENABLED=true` ve vašem **config/overleaf.rc** soubor.
* Proměnné začínající na `OVERLEAF_MONGO_`, `OVERLEAF_REDIS_` a `REDIS_HOST` proměnné již nejsou potřeba. MongoDB a Redis se nyní konfigurují v **config/overleaf.rc** souboru pomocí `MONGO_URL`, `REDIS_HOST` a `REDIS_PORT`.

Pokročilé možnosti konfigurace naleznete v [config/overleaf.rc](/on-premises/on-premises-cs/konfigurace/overleaf-toolkit/environment-variables.md) dokumentaci.
{% endstep %}

{% step %}

### Proxy NGINX

Pokyny k migraci `nginx`, naleznete v [dokumentaci k proxy TLS](/on-premises/on-premises-cs/konfigurace/overleaf-toolkit/tls-proxy.md):
{% endstep %}

{% step %}

### Svazky

Nastavte umístění datových svazků v **config/overleaf.rc**:

#### ShareLaTeX

Nastavte `v` na umístění datového svazku používaného `sharelatex` kontejneru.

#### MongoDB

Nastavte `MONGO_DATA_PATH` na umístění datového svazku používaného `mongo` kontejneru.

#### Redis

Nastavte `REDIS_DATA_PATH` na umístění datového svazku používaného `redis` kontejneru.
{% endstep %}
{% endstepper %}

Další podrobnosti a pokročilou konfiguraci naleznete v příslušné dokumentaci ke konfiguraci Toolkitu, na kterou odkazují odkazy výše.


---

# 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/on-premises-cs/udrzba/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.