> ## 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.

# Di chuyển từ bản cài đặt hiện có

> Di chuyển một bản triển khai Overleaf Toolkit hiện có sang Ayakaleaf Pro.

<Danger>
  Điều quan trọng là bạn phải tạo một [bản sao lưu nhất quán](/vi/on-premises/maintenance/data-and-backups#performing-a-consistent-backup) **trước** mỗi lần di chuyển phiên bản lớn để có thể khôi phục lại khi cần.
</Danger>

### Di chuyển từ Overleaf Community

#### Trường hợp 01: Từ Overleaf Toolkit

Nếu bạn đang sử dụng Overleaf Toolkit chính thức cho Overleaf Community, chỉ cần thêm một tệp tên là `docker-compose.override.yml` với nội dung như sau hoặc tương tự vào thư mục `overleaf-toolkit/config`:

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

Để khởi động phiên bản của bạn, hãy chạy:

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

Vậy là xong! Mọi thứ đã sẵn sàng. Tiếp theo, bạn có thể kiểm tra xem phiên bản Ayakaleaf có đang chạy đúng không và bạn có thể truy cập giao diện web hay không. Khi mọi thứ đã hoạt động, hãy tiếp tục với các bước [cấu hình](/vi/on-premises/configuration/overleaf-toolkit) bên dưới để bật các tính năng nâng cao như:

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

#### Trường hợp 02: Từ tệp Docker Compose

Nếu bạn sử dụng một tệp `docker-compose.yml` độc lập, trước tiên hãy di chuyển nó sang Overleaf Toolkit. Toolkit giúp đơn giản hóa việc cài đặt, nâng cấp và bảo trì on-premises.

Làm theo [docker-compose.yml-to-toolkit-migration.md](/vi/on-premises/maintenance/docker-compose.yml-to-toolkit-migration "mention") để chuyển đổi bản triển khai hiện có của bạn. Giữ nguyên cấu hình hiện tại và các đường dẫn volume dữ liệu trong quá trình di chuyển này.

Sau khi bản triển khai Toolkit đã chạy, hãy làm theo [#from-overleaf-toolkit](/vi/on-premises/installation/migrate-from-existing#from-overleaf-toolkit "mention") để chuyển image của nó sang Ayakaleaf Pro. Khởi động phiên bản bằng `bin/up`, sau đó kiểm tra xem bạn có thể truy cập giao diện web hay không.

***

### Di chuyển từ Overleaf Server Pro

Nếu bạn hiện đang chạy một phiên bản [Overleaf Server Pro](https://www.overleaf.com/for/enterprises) có giấy phép thương mại và muốn di chuyển sang Ayakaleaf Pro, xin lưu ý rằng quá trình di chuyển có thể cần thêm một số công việc vì một số định dạng dữ liệu (`templates`) có thể không hoàn toàn tương thích. Tuy nhiên, chúng tôi rất sẵn lòng hỗ trợ bạn. Vui lòng [mở một issue](https://github.com/ayaka-notes/ayakaleaf-pro/issues) hoặc liên hệ với chúng tôi qua [ayaka-notes@outlook.com](mailto:ayaka-notes@outlook.com), và chúng tôi sẽ giúp bạn di chuyển sang Ayakaleaf Pro miễn phí.

***

### Di chuyển từ Overleaf CEP

Chúng tôi thường xuyên nhận được câu hỏi từ người dùng về việc liệu họ có thể di chuyển từ [Overleaf CEP](https://github.com/yu-i-i/overleaf-cep) sang Ayakaleaf Pro hay không. Trong hầu hết các trường hợp, Overleaf CEP và Ayakaleaf Pro cung cấp chức năng gần như tương đương và vẫn tương thích về dữ liệu tính đến phiên bản 6.2.0. Hai dự án có thể phát hành tính năng vào những thời điểm khác nhau; ví dụ, chúng tôi có thể cherry-pick một tính năng từ Overleaf CEP, và ngược lại. Mặc dù cách triển khai cùng một tính năng của chúng tôi có thể hơi khác nhau, nhìn chung không có lý do thuyết phục nào để di chuyển.

Nếu bạn vẫn muốn di chuyển sang hoặc dùng thử Ayakaleaf Pro, vui lòng tham khảo: [#case-01-from-overleaf-toolkit](/vi/on-premises/installation/migrate-from-existing#case-01-from-overleaf-toolkit "mention"). Quy trình di chuyển là như nhau.

***

### Di chuyển từ Overleaf SaaS

Đáng tiếc là việc di chuyển từ nền tảng Overleaf SaaS sang một phiên bản Ayakaleaf Pro tự lưu trữ có thể khó khăn hơn đáng kể. Hiện tại, phương pháp phổ biến duy nhất là tải xuống từng dự án dưới dạng tệp nén ZIP rồi tải lên phiên bản Ayakaleaf Pro tự lưu trữ của bạn. Cách này chỉ chuyển các tệp hiện tại của dự án, nghĩa là bạn sẽ ***mất***:

* Toàn bộ lịch sử dự án và các revision trước đó
* Toàn bộ bình luận và các thay đổi được theo dõi
* Toàn bộ siêu dữ liệu Git và lịch sử commit
* Toàn bộ liên kết và thiết lập đồng bộ GitHub
* Toàn bộ liên kết giữa các tệp BibTeX và các nền tảng quản lý tài liệu tham khảo bên thứ ba

***

### Di chuyển từ một bản fork Overleaf của bên thứ ba

Ayakaleaf Pro có thể không hỗ trợ các tính năng dành riêng cho một bản fork Overleaf cụ thể của bên thứ ba. Khi một bản fork tách biệt đáng kể khỏi mã nguồn Overleaf upstream—hoặc đưa vào các thay đổi mà không duy trì khả năng tương thích với upstream—việc hợp nhất các bản phát hành Overleaf tiếp theo có thể trở nên cực kỳ khó khăn. Bạn vẫn có thể thử phương pháp di chuyển được mô tả ở trên, nhưng khả năng tương thích không được đảm bảo, và chúng tôi có thể không cung cấp được hỗ trợ hoặc hỗ trợ kỹ thuật cho việc di chuyển từ các bản fork không được hỗ trợ.


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