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

# 5. Cá nhân hóa phiên bản của bạn

> Đặt cổng, URL trang web và TeX Live image, bật sandboxed compiles và khởi động Ayakaleaf Pro trên WSL 2.

Chạy các lệnh và chỉnh sửa tệp trong **Ubuntu**, từ `~/ayakaleaf-toolkit`.

**1. Thiết lập container**

Chỉnh sửa các mục hiện có trong `config/overleaf.rc`:

```bash title="config/overleaf.rc" theme={null}
PROJECT_NAME=ayakaleaf-wsl
SERVER_PRO=true
OVERLEAF_LISTEN_IP=127.0.0.1
OVERLEAF_PORT=8080
SIBLING_CONTAINERS_ENABLED=true
DOCKER_SOCKET_PATH=/var/run/docker.sock
```

Hãy giữ các đường dẫn dữ liệu mặc định và các dịch vụ MongoDB và Redis đi kèm. Cổng `8080` dành cho trình duyệt cục bộ trên Windows; việc bind vào `127.0.0.1` giữ nó chỉ truy cập được cục bộ. Sandboxed compiles sử dụng một container Linux riêng cho mỗi lần biên dịch, thay vì chạy TeX bên trong container ứng dụng. Docker socket cho phép ứng dụng tạo các container đó, và Toolkit cung cấp đường dẫn trên máy chủ host cho dữ liệu biên dịch trong `data/overleaf/data/compiles`.

**2. Thiết lập ứng dụng**

Trong `config/variables.env`, đặt các giá trị sau, thay thế mọi mục đang hoạt động có cùng tên:

```dotenv title="config/variables.env" theme={null}
OVERLEAF_SITE_URL=http://localhost:8080
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES="TeX Live 2026"
```

Image full bao gồm các gói và phông chữ cần thiết cho nhiều loại dự án. Hãy dành ít nhất 40 GB dung lượng trống cho nó và ứng dụng, cộng thêm dung lượng cho dữ liệu dự án và các bản cập nhật sau này.

Để thử nghiệm triển khai nhanh, hãy dùng image **basic** nhỏ hơn. Nó đủ cho bài kiểm tra bài viết đơn giản ở bước 6, nhưng không bao gồm toàn bộ bộ gói và phông chữ:

```dotenv theme={null}
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-basic:2026.1
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-basic:2026.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES="TeX Live 2026 Basic"
```

Hãy chọn một trong hai bộ này, không để các khóa đang hoạt động bị trùng lặp. [Dockerfile](https://github.com/ayaka-notes/texlive-full/blob/main/texlive/2026/Dockerfile.basic) của image basic bao gồm `latexmk`, XeTeX và `fontspec`, nhưng không có `ctex` hay bộ sưu tập phông chữ đầy đủ. Việc thiếu một gói LaTeX trong image basic tự nó không cho thấy có vấn đề với sandbox.

Tạo một session secret:

```bash theme={null}
openssl rand -hex 32
```

Thêm kết quả dưới dạng `OVERLEAF_SESSION_SECRET` trong `config/variables.env`. Hãy giữ cả invite-token secret đã được tạo. Đối với một phiên bản cục bộ không dùng email, hãy để trống các thiết lập SMTP và `OVERLEAF_EMAIL_FROM_ADDRESS`.

**3. Khởi động phiên bản của bạn**

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

Toolkit khởi động MongoDB, khởi tạo replica set của nó, tải xuống TeX Live image đã chọn, rồi khởi động Redis và ứng dụng. Nó có thể trông như đang tạm dừng trong khi một image lớn đang được tải xuống. Không chạy `bin/up` lần thứ hai khi lần đầu vẫn đang hoạt động.

Trong một terminal Ubuntu khác, hãy kiểm tra:

```bash theme={null}
cd "$HOME/ayakaleaf-toolkit"
bin/docker-compose ps
bin/docker-compose logs --tail=100 mongo
bin/docker-compose logs --tail=100 -f sharelatex
```

Nhấn `Ctrl+C` để ngừng theo dõi log; các container chạy ở chế độ detached vẫn tiếp tục chạy. Nếu quá trình khởi động thất bại ở MongoDB, hãy làm theo [MongoDB không khởi động được](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/windows/troubleshooting.md#mongodb-fails-to-start) trước khi thử lại. Không xóa thư mục dữ liệu của nó để đặt lại một bản cài đặt hiện có.

Kiểm tra cổng và trang chạy lần đầu:

```bash theme={null}
bin/docker-compose port sharelatex 80
curl -I http://localhost:8080/launchpad
```

Cổng phải là `127.0.0.1:8080`. Hãy đợi ứng dụng khởi tạo xong nếu yêu cầu HTTP ban đầu thất bại.

**4. Mở phiên bản từ Windows**

Trong **trình duyệt trên Windows**, mở [http://localhost:8080/launchpad](http://localhost:8080/launchpad). Hãy dùng địa chỉ này cả trên Windows, thay vì một địa chỉ IP WSL tạm thời.

Để kiểm tra quyền truy cập HTTP từ Windows tách biệt với trình duyệt, hãy chạy trong **PowerShell**:

```powershell theme={null}
curl.exe -I http://localhost:8080/launchpad
```

Nếu Ubuntu truy cập được trang nhưng Windows thì không, xem [Windows không mở được localhost](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/windows/troubleshooting.md#windows-cannot-open-localhost).

### Bước tiếp theo

Tiếp tục với [6. Các tác vụ sau cài đặt](https://ayakaleaf-pro.mintlify.site/vi/on-premises/installation/using-docker-compose/windows/6.-post-installation-tasks.md) để tạo quản trị viên và xác minh sandboxed compiles cũng như tính bền vững của dữ liệu.


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