> 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/cs/instalace/migrace-z-existujiciho.md).

# Migrace z existujícího

{% hint style="danger" %}
Je důležité zajistit, abyste vytvořili [konzistentní zálohu](/on-premises/cs/udrzba/data-and-backups.md#performing-a-consistent-backup) **před** každou hlavní migrací verze, abyste se v případě potřeby mohli vrátit zpět.
{% endhint %}

### Migrace z Overleaf Community

#### Případ 01: Z Overleaf Toolkit

Pokud používáte oficiální Overleaf Toolkit pro Overleaf Community, stačí přidat soubor s názvem `docker-compose.override.yml` s následujícím nebo podobným obsahem do `overleaf-toolkit/config` adresáře:

{% code title="docker-compose.override.yml" %}

```yml
---
services:
    sharelatex:
        image: ghcr.io/ayaka-notes/overleaf-pro:X.x.x # změňte na konkrétní verzi
```

{% endcode %}

Chcete-li spustit svou instanci, spusťte:

```bash
bin/up
```

To je vše! Všechno je připraveno. Dále můžete ověřit, že vaše instance AyakaLeaf běží správně a že máte přístup k webovému rozhraní. Jakmile bude vše fungovat, pokračujte s [konfigurací](/on-premises/cs/konfigurace/overleaf-toolkit.md) kroky níže, abyste povolili pokročilé funkce, jako jsou:

* [Kompilace v izolovaném prostředí](/on-premises/cs/konfigurace/overleaf-toolkit/sandboxed-compiles.md)
* [Autentizace](/on-premises/cs/konfigurace/overleaf-toolkit/authentication.md)
* [Synchronizace s GitHubem](/on-premises/cs/konfigurace/overleaf-toolkit/github-synchronisation.md)
* [Integrace Zotera](/on-premises/cs/konfigurace/overleaf-toolkit/zotero-integration.md)

#### Případ 02: Z Docker Compose souboru

Pokud používáte samostatný `docker-compose.yml`, nejprve jej přesuňte do Overleaf Toolkit. Toolkit zjednodušuje instalaci v místním prostředí, upgrady a údržbu.

Postupujte podle [Migrace z docker-compose.yml do Toolkitu](/on-premises/cs/udrzba/docker-compose.yml-to-toolkit-migration.md) pro převod vaší stávající instalace. Během této migrace zachovejte svou současnou konfiguraci a cesty datových svazků.

Jakmile je nasazení Toolkit spuštěno, postupujte podle [Migrace z existujícího](/on-premises/cs/instalace/migrace-z-existujiciho.md#from-overleaf-toolkit) pro změnu jeho image na AyakaLeaf Pro. Spusťte instanci pomocí `bin/up`, a poté ověřte, že máte přístup k webovému rozhraní.

***

### Migrace z Overleaf Server Pro

Pokud právě provozujete komerčně licencovanou instanci [Overleaf Server Pro](https://www.overleaf.com/for/enterprises) a chcete migrovat na AyakaLeaf Pro, mějte prosím na paměti, že migrace může vyžadovat další práci, protože některé datové formáty (`šablony`) nemusí být zcela kompatibilní. Rádi vám však pomůžeme. Prosím [otevřete issue](https://github.com/ayaka-notes/ayakaleaf-pro/issues) nebo nás kontaktujte na <ayaka-notes@outlook.com>, a pomůžeme vám s migrací na naši AyakaLeaf Pro zcela zdarma.

***

### Migrace z Overleaf CEP

Často dostáváme od uživatelů dotazy, zda mohou migrovat z [Overleaf CEP](https://github.com/yu-i-i/overleaf-cep) na AyakaLeaf Pro. Ve většině případů nabízejí Overleaf CEP a AyakaLeaf Pro zhruba ekvivalentní funkce a od verze 6.2.0 zůstávají datově kompatibilní. Oba projekty mohou vydávat funkce v různou dobu; například můžeme zpětně přenést funkci z Overleaf CEP a naopak. Ačkoli se naše implementace stejné funkce mohou mírně lišit, obvykle neexistuje pádný důvod k migraci.

Pokud byste přesto chtěli migrovat na nebo si vyzkoušet AyakaLeaf Pro, podívejte se prosím na: [#case-01-from-overleaf-toolkit](#case-01-from-overleaf-toolkit "mention"). Proces migrace je stejný.

***

### Migrace z Overleaf SaaS

Migrace z platformy Overleaf SaaS na vlastní hostovanou instanci AyakaLeaf Pro může být bohužel výrazně obtížnější. V současnosti je jedinou běžně dostupnou metodou stáhnout každý projekt jako archiv ZIP a poté jej nahrát do vaší vlastní hostované instance AyakaLeaf Pro. Tím se přenesou pouze aktuální soubory projektu, což znamená, že budete *<mark style="color:$danger;">**ztratit**</mark>*:

* Veškerou historii projektu a předchozí revize
* Všechny komentáře a sledované změny
* Veškerá metadata Git a historie commitů
* Veškeré propojení se synchronizací GitHubu a nastavení
* Všechny odkazy mezi soubory BibTeX a platformami pro správu referencí třetích stran

***

### Migrace z forků Overleaf třetích stran

AyakaLeaf Pro nemusí podporovat funkce, které jsou specifické pro konkrétní fork Overleaf od třetí strany. Jakmile se fork výrazně odchýlí od upstreamové kódové základny Overleaf — nebo zavede změny bez zachování kompatibility s upstreamem — může být začlenění následných verzí Overleaf velmi obtížné. Stále můžete zkusit výše popsaný způsob migrace, ale kompatibilita není zaručena a my nemusíme být schopni poskytnout pomoc ani technickou podporu pro migrace z nepodporovaných forků.


---

# 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/cs/instalace/migrace-z-existujiciho.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.
