เริ่มต้นอย่างรวดเร็ว

ข้อกำหนด

ข้อกำหนด	ขั้นต่ำ	แนะนำ
Node.js	22.22+	LTS ล่าสุด
RAM	8 GB	16 GB ขึ้นไป
ดิสก์	5 GB	20 GB ขึ้นไปสำหรับโมเดล
GPU	ไม่บังคับ	VRAM 8 GB ขึ้นไปเพื่อการอนุมานในเครื่องที่รวดเร็ว
Docker	ไม่บังคับ	จำเป็นสำหรับงาน Work

Libre WebUI ใช้งาน Ollama ด้วย CPU เท่านั้นได้ แต่โมเดลขนาดเล็กเหมาะกับ CPU มากกว่า สำหรับปลั๊กอินผู้ให้บริการระบบคลาวด์ คุณต้องมีเพียงคีย์ API ที่เกี่ยวข้อง

Chat, เอกสาร, artifacts และฟีเจอร์ที่ใช้ผู้ให้บริการไม่ต้องใช้ Docker แต่ Work ต้องใช้: ต้องติดตั้ง Docker บนเครื่องที่รัน backend ของ Libre WebUI และโปรเซส backend ต้องมีสิทธิ์เรียกใช้ คำสั่ง npx libre-webui ไม่ได้ติดตั้ง Docker หาก Docker ใช้ไม่ได้ ส่วนอื่นของ Libre WebUI จะยังทำงานต่อ ขณะที่ Work แสดง Runtime unavailable; ระบบจะไม่รันคำสั่งโมเดลบนโฮสต์โดยตรงเป็นวิธีสำรอง

เริ่ม Libre WebUI

npx libre-webui@latest

เปิด http://localhost:8080 แล้วสร้างบัญชีแรก บัญชีนั้นจะเป็นผู้ดูแลระบบ การลงทะเบียนสาธารณะในภายหลังจะปิดอยู่ เว้นแต่คุณตั้ง ENABLE_SIGNUP=true อย่างชัดเจน

ตัวเปิดแบบแพ็กเกจจะเก็บสถานะถาวรใน ~/.libre-webui หากต้องการตำแหน่งอื่น ให้ตั้ง DATA_DIR เป็นเส้นทางแบบสัมบูรณ์ ส่วนค่าที่เป็นเส้นทางสัมพัทธ์จะคำนวณจากไดเรกทอรีที่คุณรัน npx

ติดตั้ง Ollama

ติดตั้ง Ollama แล้วดาวน์โหลดโมเดลทั่วไปขนาดเล็ก:

ollama pull gemma4:12b

ตัวเลือกที่มีประสิทธิภาพอื่น ได้แก่ gemma4:26b (MoE), gemma4:31b (dense) และ qwen3.8:27b ใช้ Model Manager ใน Libre WebUI เพื่อดูโมเดลที่ติดตั้ง ค้นหา Ollama Library แบบสด และดาวน์โหลดโมเดลโดยไม่ออกจากแอป

Embedding สำหรับเอกสาร

สำหรับการค้นหาเอกสารเชิงความหมาย ให้ติดตั้งโมเดล embedding เพิ่มเติม:

ollama pull nomic-embed-text

เพิ่มผู้ให้บริการระบบคลาวด์

ผู้ให้บริการระบบคลาวด์เป็นทางเลือก เพิ่มคีย์แยกต่อผู้ใช้ที่ Settings → API keys หรือเพิ่มสำหรับทั้งเซิร์ฟเวอร์ใน backend/.env (จากนั้นรีสตาร์ต backend) แล้วเปิดผู้ให้บริการใน 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=...

แอปจะรีเฟรชรายการโมเดลของผู้ให้บริการเมื่อรองรับ คุณไม่ต้องเปิดเอกสารไว้เพื่อค้นหาชื่อโมเดลล่าสุด

เริ่มงาน Work แรก

Work ให้บทสนทนาถาวรและระบบไฟล์ที่ใช้คอนเทนเนอร์แยกกันแก่แต่ละงาน ฟีเจอร์นี้พร้อมใช้สำหรับผู้ดูแลระบบที่ยืนยันตัวตนแล้ว

1. ติดตั้งและเริ่ม Docker บนเครื่องที่รัน backend ของ Libre WebUI
2. เริ่มงานจากปุ่ม Work ในส่วนหัวแถบด้านข้าง เมนู + ของแถบแท็บ หน้า Home หรือ Cmd/Ctrl + Shift + U
3. เลือกโมเดลที่รองรับการเรียกเครื่องมือ
4. อธิบายสิ่งที่ต้องการสร้างหรือเปลี่ยน แล้วเลือก Run
5. ติดตามผลในแท็บ Files, Activity, Git, Terminal และ Preview ของแผงพื้นที่ทำงาน

งานจะอยู่ในแถบด้านข้างเพื่อให้คุณกลับมาที่บทสนทนาและไฟล์เดิมได้ การหยุดรอบหรือภาพตัวอย่างจะรักษาพื้นที่ทำงานไว้ ส่วนการลบงานจะลบพื้นที่ทำงานอย่างถาวร

Work ใช้ได้กับโมเดล Ollama ที่ติดตั้งไว้ โมเดล Ollama Cloud หรือปลั๊กอินผู้ให้บริการ chat/completion ที่กำหนดค่าไว้ เมื่อเลือกผู้ให้บริการระยะไกล Libre WebUI จะแสดงคำชี้แจงก่อนรัน: ผู้ให้บริการจะได้รับบทสนทนา คำนิยามเครื่องมือ และผลลัพธ์เครื่องมือที่โมเดลร้องขอ การรันอัตโนมัติหนึ่งรอบอาจเรียกผู้ให้บริการแบบมีค่าใช้จ่ายหลายครั้ง

ดูรายละเอียด runtime, การจัดเก็บ, เครือข่าย, ตัวอย่าง และความปลอดภัยได้ที่ Work: พื้นที่ทำงานที่แยกออกจากกัน

Docker

git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d

สร้างผู้ดูแลระบบคนแรกในเบราว์เซอร์ ไม่ต้องใช้แฟล็กลงทะเบียนหรือรีสตาร์ต การลงทะเบียนสาธารณะหลังจากนั้นปิดตามค่าเริ่มต้น

หาก Ollama ทำงานอยู่บนโฮสต์หรือเครื่องอื่นแล้ว:

docker compose -f docker-compose.external-ollama.yml up -d

สำหรับการเร่งด้วย NVIDIA GPU ใช้ไฟล์ Compose สำหรับ GPU ที่ repository จัดเตรียมไว้

ไฟล์ Compose ใน repository จะ mount Docker socket ของโฮสต์เพื่อให้ Work พร้อมใช้เมื่อติดตั้ง Docker การทำเช่นนี้ให้สิทธิ์ควบคุมโฮสต์เทียบเท่า root แก่แอป จึงควรอ่าน Work: พื้นที่ทำงานที่แยกออกจากกัน ก่อน บน Linux ให้ตั้ง DOCKER_GID ใน .env เป็นกลุ่มเจ้าของ socket หากไม่ต้องการ Work ให้เอา mount ออก

Ollama ที่รวมมาด้วยจะเข้าถึงได้เฉพาะภายในเช่นกัน เพิ่ม -f docker-compose.ollama-host.yml เฉพาะเมื่อโปรเซสอื่นบนโฮสต์ต้องใช้ API โดย override จะ bind กับ loopback ตามค่าเริ่มต้น

สำรวจส่วนต่าง ๆ

แท็บ Home มีสามส่วน: Start (แชตใหม่ แชตไม่ระบุตัวตน งาน Work ใหม่), Continue (บทสนทนาและงานล่าสุด), และ Explore (Notes, Calendar, Automations, Models, Personas, Imagine) ปลายทางเดียวกันอยู่ในแถบนำทางของแถบด้านข้างและชุดคำสั่ง (Cmd/Ctrl + K) ซึ่งค้นหาแบบคลุมเครือในแชต งาน Work และการทำงานของแอป พร้อมค้นหาข้อความแบบเต็มในข้อความ โน้ต และเอกสารของคุณ

• ปฏิทิน — ปฏิทินแยกตามผู้ใช้พร้อมเหตุการณ์ที่ทำซ้ำ
• การทำงานอัตโนมัติ — งาน AI ตามกำหนดเวลาที่ส่งเป็นเซสชันแชต

แป้นพิมพ์ลัด

แป้นพิมพ์ลัด	การทำงาน
Cmd/Ctrl + K	ชุดคำสั่ง (ใช้ได้ขณะพิมพ์)
Cmd/Ctrl + Shift + O	แชตใหม่
Cmd/Ctrl + Shift + U	งาน Work ใหม่
Cmd/Ctrl + B	แสดง/ซ่อนแถบด้านข้าง
Cmd/Ctrl + ,	Settings
Cmd/Ctrl + D	สลับธีม
?	เปิด Settings ที่แท็บ Shortcuts
Esc	ปิดหน้าต่าง Settings
Enter	ส่งข้อความ
Shift + Enter	ขึ้นบรรทัดใหม่

ขั้นตอนถัดไป

• การทำงานกับโมเดล
• Work: พื้นที่ทำงานที่แยกออกจากกัน
• ปฏิทิน
• การทำงานอัตโนมัติ
• ข้อกำหนดฮาร์ดแวร์
• แชตเอกสาร
• Artifacts
• Docker