> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrace ze stávající instalace

> Migrace stávajícího nasazení Overleaf Toolkit na Ayakaleaf Pro.

<Danger>
  Je důležité, abyste si **před** každou migrací na novou hlavní verzi pořídili [konzistentní zálohu](/cs/on-premises/maintenance/data-and-backups#performing-a-consistent-backup), abyste se v případě potřeby mohli vrátit zpět.
</Danger>

### Migrace z Overleaf Community

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

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

```yml title="docker-compose.override.yml" theme={null}
---
services:
    sharelatex:
        image: ghcr.io/ayaka-notes/overleaf-pro:X.x.x # change to specific version
```

Instanci spustíte příkazem:

```bash theme={null}
bin/up
```

A je to! Vše 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 vše funguje, pokračujte kroky [konfigurace](/cs/on-premises/configuration/overleaf-toolkit) níže a povolte pokročilé funkce, jako jsou:

* [sandboxed-compiles.md](/cs/on-premises/configuration/overleaf-toolkit/sandboxed-compiles "mention")
* [authentication](/cs/on-premises/configuration/overleaf-toolkit/authentication "mention")
* [github-synchronisation.md](/cs/on-premises/configuration/overleaf-toolkit/github-synchronisation "mention")
* [zotero-integration.md](/cs/on-premises/configuration/overleaf-toolkit/zotero-integration "mention")

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

Pokud používáte samostatný `docker-compose.yml`, nejprve jej migrujte na Overleaf Toolkit. Toolkit zjednodušuje on-premises instalaci, upgrady i údržbu.

Při převodu stávajícího nasazení postupujte podle [docker-compose.yml-to-toolkit-migration.md](/cs/on-premises/maintenance/docker-compose.yml-to-toolkit-migration "mention"). Během této migrace zachovejte svou současnou konfiguraci a cesty k datovým svazkům.

Jakmile nasazení s Toolkitem běží, postupujte podle [#from-overleaf-toolkit](/cs/on-premises/installation/migrate-from-existing#from-overleaf-toolkit "mention") a přepněte 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 aktuálně provozujete komerčně licencovanou instanci [Overleaf Server Pro](https://www.overleaf.com/for/enterprises) a chtěli byste přejít na Ayakaleaf Pro, mějte na paměti, že migrace může vyžadovat určitou práci navíc, protože některé datové formáty (`templates`) nemusí být plně kompatibilní. Rádi vám však pomůžeme. [Založte prosím issue](https://github.com/ayaka-notes/ayakaleaf-pro/issues) nebo nás kontaktujte na [ayaka-notes@outlook.com](mailto:ayaka-notes@outlook.com) a s migrací na Ayakaleaf Pro vám bezplatně pomůžeme.

***

### 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 v zásadě rovnocennou funkcionalitu a od verze 6.2.0 zůstávají datově kompatibilní. Oba projekty mohou vydávat funkce v různých termínech; například můžeme převzít (cherry-pick) funkci z Overleaf CEP a naopak. Přestože se naše implementace téže funkce mohou mírně lišit, obecně neexistuje pádný důvod k migraci.

Pokud byste přesto chtěli na Ayakaleaf Pro migrovat nebo jej vyzkoušet, podívejte se na: [#case-01-from-overleaf-toolkit](/cs/on-premises/installation/migrate-from-existing#case-01-from-overleaf-toolkit "mention"). Postup migrace je stejný.

***

### Migrace z Overleaf SaaS

Migrace z platformy Overleaf SaaS na vlastní hostovanou instanci Ayakaleaf Pro bohužel může být podstatně obtížnější. V současnosti je jedinou obecně dostupnou metodou stáhnout každý projekt jako ZIP archiv a poté jej nahrát do své vlastní instance Ayakaleaf Pro. Tím se přenesou pouze aktuální soubory projektu, což znamená, že ***přijdete o***:

* Veškerou historii projektu a předchozí revize
* Všechny komentáře a sledované změny
* Všechna metadata Gitu a historii commitů
* Všechna propojení a nastavení synchronizace s GitHubem
* Všechna propojení mezi soubory BibTeX a platformami pro správu citací třetích stran

***

### Migrace z forku Overleafu třetí strany

Ayakaleaf Pro nemusí podporovat funkce specifické pro konkrétní fork Overleafu třetí strany. Jakmile se fork výrazně odchýlí od upstreamového kódu Overleafu — nebo zavede změny bez zachování kompatibility s upstreamem — může být slučování následných vydání Overleafu nesmírně obtížné. Můžete se přesto pokusit o migraci výše popsaným způsobem, ale kompatibilita není zaručena a u migrací z nepodporovaných forků vám možná nebudeme schopni poskytnout pomoc ani technickou podporu.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.