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

# Migrace z docker-compose.yml na Toolkit

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

Pro migraci budete muset převést své 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.

Tento průvodce vás provede každým krokem tohoto procesu a zajistí hladkou migraci z Docker Compose na Toolkit.

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

{% stepper %}
{% step %}

### Naklonujte repozitář Toolkitu

Nejprve naklonujte repozitář Toolkitu na hostitelský počítač:

```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` jsou obraz a verze definovány v popisu komponenty, například:

```yaml
version: '2.2'
služby:
    sharelatex:
        restart: always
        # Pro uživatele Server Pro:
        # image: quay.io/sharelatex/sharelatex-pro
        image: sharelatex/sharelatex:3.5.13
```

Při použití Toolkitu se název obrazu vyřeší 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 je nastaveno 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ší místní `latest` verze, a poté použijte poznámky k vydání pro 2.x.x, 3.x.x, 4.x.x nebo 5.x.x k přiřazení ID obrazu k verzi.

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

{% step %}

### Nastavení externího přístupu

Ve výchozím nastavení bude Overleaf naslouchat na `127.0.0.1:80`, a bude povolovat pouze provoz 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ě budete mít sadu proměnných prostředí definovanou v `sharelatex` službě ve vašem `docker-compose.yml`, například:

```yaml
prostředí:
    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í formu (použijte `=` místo `:`):

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

Výjimky / rozdíly při použití 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_` i `REDIS_HOST` proměnná již nejsou potřeba. MongoDB a Redis jsou nyní konfigurovány v **config/overleaf.rc** souboru pomocí `MONGO_URL`, `REDIS_HOST` a `REDIS_PORT`.

Pro pokročilé možnosti konfigurace se podívejte na [config/overleaf.rc](/on-premises/on-premises-cs/konfigurace/overleaf-toolkit/environment-variables.md) dokumentaci.
{% endstep %}

{% step %}

### NGINX proxy

Pokyny, jak migrovat `nginx`, viz [dokumentace TLS Proxy](/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 `OVERLEAF_DATA_PATH` 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 najdete v příslušné dokumentaci ke konfiguraci Toolkitu odkazované 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://ayakaleaf-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.