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

​

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

Trước khi khởi động phiên bản Overleaf của bạn lần đầu tiên, hãy cập nhật tệp cấu hình config/variables.env với thông tin tùy chỉnh của bạn.

1. Chỉnh sửa tệp biến

   Mở config/variables.env bằng trình soạn thảo văn bản yêu thích và cập nhật các biến môi trường dưới đây với các giá trị cần thiết.

2. Các biến môi trường bắt buộc

   Cập nhật các biến sau trong config/variables.env:

   Tên	Mô tả	Ví dụ
   OVERLEAF_SITE_URL	Địa chỉ công khai của phiên bản Overleaf của bạn. Giá trị này được dùng trong các liên kết công khai và khi kết nối qua websocket, vì vậy phải được cấu hình chính xác!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	Địa chỉ email này sẽ được dùng làm địa chỉ from cho tất cả email gửi đi.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	Địa chỉ email mà người dùng có thể liên hệ với người vận hành trang.	[e-mail]

   Sau khi cập nhật các biến môi trường này, hãy lưu và thoát.

3. Thiết lập Sandbox Compile

   Tiếp theo, cấu hình TeX Live Full cho sandboxed-compiles.md. Mở config/variables.env và cập nhật các biến môi trường sau:

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
4. Khởi động phiên bản của bạn

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

   Start the instance

   bin/up
   

   Lệnh này sẽ tải xuống các image cần thiết bao gồm texlive, tạo các container (sử dụng các tùy chỉnh của bạn) và khởi động phiên bản. Bạn sẽ thấy đầu ra log từ các Docker container khác nhau.

   Để khởi động lại chúng sau này (không gắn vào đầu ra log), hãy chạy:

   Start without attaching to logs

   bin/start
   

Toolkit sử dụng docker compose để quản lý các Docker container của Overleaf. Toolkit cung cấp một bộ script bao bọc docker compose và xử lý hầu hết các chi tiết thay cho bạn.

Nếu mọi thứ suôn sẻ, bạn sẽ có thể xem trang đăng nhập của phiên bản Overleaf mới bằng cách truy cập http://127.0.0.1/ hoặc http://localhost/ trong trình duyệt.

Tùy thuộc vào cấu hình mạng và nơi lưu trữ phiên bản Overleaf của bạn, bạn có thể cần thực hiện thêm các thay đổi cấu hình. Xem thiết lập Toolkit để biết thêm chi tiết: toolkit-settings.md