Bắt đầu nhanh
Yêu cầu
| Thành phần | Tối thiểu | Khuyến nghị |
|---|---|---|
| Node.js | 22.22+ | LTS mới nhất |
| RAM | 8 GB | 16 GB+ |
| Ổ đĩa | 5 GB | 20 GB+ cho mô hình |
| GPU | Không bắt buộc | 8 GB+ VRAM để suy luận cục bộ nhanh |
| Docker | Không bắt buộc | Bắt buộc cho tác vụ Work |
Libre WebUI hoạt động với Ollama chỉ dùng CPU, nhưng mô hình nhỏ phù hợp hơn. Plugin nhà cung cấp đám mây chỉ cần khóa API tương ứng.
Chat, tài liệu, hiện vật và tính năng dựa trên nhà cung cấp không cần Docker. Work thì cần: Docker phải được cài trên máy chạy backend Libre WebUI và tiến trình backend phải được phép gọi Docker. Lệnh npx libre-webui không cài Docker. Nếu Docker không khả dụng, phần còn lại của Libre WebUI vẫn chạy còn Work báo Runtime unavailable; lệnh mô hình không bao giờ được chạy trực tiếp trên máy chủ như phương án dự phòng.
Khởi chạy Libre WebUI
npx libre-webui@latest
Mở http://localhost:8080. Tạo tài khoản đầu tiên; tài khoản đó trở thành quản trị viên. Đăng ký công khai tiếp theo vẫn tắt trừ khi đặt rõ ENABLE_SIGNUP=true.
Trình khởi chạy đóng gói giữ trạng thái tại ~/.libre-webui. Đặt DATA_DIR tuyệt đối để chọn vị trí khác; giá trị tương đối được giải quyết từ thư mục chạy npx.
Cài Ollama
Cài Ollama, rồi tải mô hình nhỏ:
ollama pull gemma4:12b
Các lựa chọn tốt khác là gemma4:26b (MoE), gemma4:31b (dense) và qwen3.8:27b. Dùng Model Manager trong Libre WebUI để xem mô hình đã cài, tìm Ollama Library và tải mô hình.
Cài thêm mô hình embedding để tìm kiếm ngữ nghĩa:
ollama pull nomic-embed-text
Thêm nhà cung cấp đám mây
Nhà cung cấp đám mây là tùy chọn. Thêm khóa theo người dùng tại Settings → API keys hoặc toàn máy chủ trong backend/.env (sau đó khởi động lại backend), rồi kích hoạt nhà cung cấp trong Settings:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
Ứng dụng làm mới danh sách mô hình khi được hỗ trợ.
Bắt đầu tác vụ Work đầu tiên
Work cung cấp hội thoại bền vững và hệ thống tệp riêng dựa trên vùng chứa. Chỉ quản trị viên đã xác thực mới dùng được.
- Cài và chạy Docker trên máy backend.
- Bắt đầu từ nút Work, menu
+, trang Home hoặcCmd/Ctrl + Shift + U. - Chọn mô hình hỗ trợ gọi công cụ.
- Mô tả việc cần làm rồi chọn Run.
- Theo dõi trong Files, Activity, Git, Terminal, Preview.
Tác vụ ở lại thanh bên để bạn quay lại. Dừng chạy hoặc xem trước vẫn giữ không gian làm việc. Xóa tác vụ sẽ xóa vĩnh viễn không gian đó.
Work dùng được Ollama, Ollama Cloud hoặc plugin chat/completion. Với nhà cung cấp từ xa, Libre WebUI thông báo rằng nhà cung cấp nhận hội thoại, định nghĩa công cụ và kết quả công cụ. Một lần chạy tự động có thể phát sinh nhiều cuộc gọi tính phí.
Xem Work: Không gian làm việc cô lập để biết chi tiết runtime, lưu trữ, mạng và bảo mật.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Tạo quản trị viên đầu tiên trong trình duyệt. Không cần cờ đăng ký hay khởi động lại.
Nếu Ollama đã chạy ở máy khác:
docker compose -f docker-compose.external-ollama.yml up -d
Dùng tệp Compose GPU cho NVIDIA.
Các tệp Compose gắn socket Docker của máy chủ để Work hoạt động. Điều này trao quyền tương đương root; đọc Work: Không gian làm việc cô lập. Trên Linux đặt DOCKER_GID trong .env. Gỡ socket nếu không dùng Work.
Ollama đóng gói cũng chỉ nội bộ. Chỉ thêm -f docker-compose.ollama-host.yml khi tiến trình khác cần API.
Điều hướng ứng dụng
Tab Home có Start, Continue, Explore. Các đích tương tự có trong thanh bên và bảng lệnh (Cmd/Ctrl + K) để tìm chat, Work, tin nhắn, ghi chú và tài liệu.
Phím tắt
| Phím | Hành động |
|---|---|
Cmd/Ctrl + K | Bảng lệnh |
Cmd/Ctrl + Shift + O | Chat mới |
Cmd/Ctrl + Shift + U | Work mới |
Cmd/Ctrl + B | Thanh bên |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Đổi giao diện |
? | Settings/Shortcuts |
Esc | Đóng cài đặt |
Enter | Gửi |
Shift + Enter | Dòng mới |