LibreChat

קבצים מוכנים להפעלה

רמת תמיכה נתמך

תבנית Compose מהמקורות הרשמיים; עוד לא נבדקה בהרצה.

צור docker-compose

שדרוג וחזרה לאחור

איך עוברים לגרסה חדשה בבטחה, ואיך חוזרים אחורה אם משהו נכשל.

קודם גיבוי

לפני כל עדכון יש לגבות את MongoDB ‏(mongodump או ה-volume של mongodb-data כשהוא עצור) ואת ה-volumes של הנתונים, ההעלאות והתמונות של LibreChat; ה-migration של האינדקסים ב-v0.8.8 עצמה דורשת גיבוי של MongoDB קודם. [2][22]

שלבי השדרוג

1. יש לקרוא את ה-release notes ואת UPGRADING.md של כל גרסה בין הגרסה הנוכחית לגרסת היעד, ולחפש migrations וברירות מחדל שהשתנו. [22][23]
2. יש להגדיר בקובץ ה-Compose את התגית המוצמדת החדשה registry.librechat.ai/librechat-ai/librechat:vX.Y.Z (ואת תגית rag_api המתאימה), ואז להריץ docker compose pull ו-docker compose up -d. ה-volumes נשמרים. [17]נגזרהתיעוד מעדכן את ה-checkout הרשמי עם git pull ו-docker compose pull; עם תגיות מוצמדות, אותו pull והפעלה מחדש נובעים מהעלאת התגית.
3. מ-v0.8.7 ומטה ל-v0.8.8: יש לעצור את שירות librechat, להשאיר את MongoDB פועל ולהריץ docker compose run --rm --no-deps -w /app librechat npm run migrate:tenant-indexes (קודם dry run), ואז להפעיל אותו מחדש. [22]
4. יש להשאיר ללא שינוי את JWT_SECRET, ‏JWT_REFRESH_SECRET, ‏CREDS_KEY ו-CREDS_IV; ערכים חדשים מנתקים משתמשים ומשאירים מפתחות משתמשים שמורים בלי אפשרות פענוח. [4]
5. בהעלאת התגית של Meilisearch יש להפעיל אותו עם volume ריק של meili-data ולהריץ npm run reset-meili-sync ב-container של librechat, כדי ש-LibreChat יבנה את האינדקס מחדש מ-MongoDB. [8]

חזרה לאחור

יש להצמיד את תגיות ה-image הקודמות ולהריץ docker compose up -d. אם הגרסה החדשה שינתה אינדקסים או נתונים (כמו ה-migration של אינדקסי ה-tenant), יש לשחזר את גיבוי MongoDB שנלקח לפני העדכון. [22]נגזר‏LibreChat לא מתעד דרך לחזור לגרסה קודמת; זה נובע מהתגיות המוצמדות ומגיבוי MongoDB ש-UPGRADING.md דורש.

שינויים שוברים ידועים

• בגרסה 0.8.8: מסדי נתונים מ-v0.8.7 ומטה עלולים לרשום Index build failed עד שמריצים את ה-migration של אינדקסי ה-tenant ‏(npm run migrate:tenant-indexes); ההפעלה לא מריצה אותה בעצמה. [22][23]
• בגרסה 0.8.8: ההפעלה נחסמת כש-JWT_SECRET או JWT_REFRESH_SECRET הם ברירת מחדל ישנה שפורסמה, או כש-CREDS_KEY / ‏CREDS_IV אינם בדיוק 64 / 32 תווי hex; ‏.env.example כבר לא מגיע עם credentials לדוגמה. [4][5][23]
• בגרסה 0.8.8: סנכרון החיפוש הראשון אחרי העדכון בונה מחדש את האינדקס של שיחות והודעות קיימות, עם עומס זמני גבוה יותר על MongoDB ו-Meilisearch בהתקנות גדולות. [8]

מגבלות

• אין מודלים מקומיים: כל שיחה נשלחת ל-API של ספק חיצוני (OpenAI, ‏Anthropic, ‏Google, או endpoints תואמי OpenAI שמוגדרים ב-librechat.yaml, שהקובץ הזה לא מחבר). עלויות ה-tokens מחויבות על ידי הספקים, והנתונים יוצאים מהשרת. [3][17]
• חיפוש בקבצים דורש מפתח ל-embeddings: ה-image ה-lite של rag_api קורא רק ל-embeddings מרוחקים (OpenAI כברירת מחדל), ולכן העלאות לחיפוש בקבצים נכשלות עד ש-RAG_OPENAI_API_KEY מכיל מפתח אמיתי. [9][10]
• ‏MongoDB 8 דורש מעבד עם הוראות AVX; הוא קורס בהפעלה על מעבדים או מכונות וירטואליות בלי AVX. [17]
• האינדקס של Meilisearch אף פעם לא מתכווץ (LMDB שומר מקום שהתפנה) ואי אפשר לחזות את גודלו בדיוק; המספרים כאן מבוססים על המדידה היחידה שבתיעוד. בשרת משותף גם MongoDB קובע את גודל ה-cache שלו לפי כל ה-RAM של השרת, אלא אם מוגדר --wiredTigerCacheSizeGB. [27][31]

אבטחה

• החשבון הראשון שנרשם הופך למנהל, והרשמה עם אימייל פתוחה כברירת מחדל. צרו את החשבון שלכם מיד אחרי ההפעלה הראשונה, ואז הגדירו את ALLOW_REGISTRATION ל-false. [4][17]
• ‏CREDS_KEY ו-CREDS_IV מצפינים את מפתחות ה-API שמשתמשים שומרים; שינוי שלהם לא מצפין מחדש רשומות קיימות. שמרו אותם ואת סודות ה-JWT במאגר הסודות שלכם, ואל תשתמשו בערכים לדוגמה. [4][5]
• יש להשאיר את Meilisearch ‏(7700), ‏MongoDB ‏(27017), ‏PostgreSQL ‏(5432) ו-rag_api ‏(8000) ברשת הפנימית; רק פורט 3080 נחשף מאחורי ה-reverse proxy עם HTTPS. [2][8][11]

גיבוי

• יש לגבות יחד את MongoDB (משתמשים, שיחות, agents, מפתחות שמורים), את ה-volumes של הנתונים, ההעלאות והתמונות ואת הסודות שב-.env: אי אפשר לקרוא מפתחות מוצפנים בלי CREDS_KEY ו-CREDS_IV התואמים. [2][4][22]
• את ה-volume של Meilisearch אפשר לבנות מחדש מ-MongoDB עם npm run reset-meili-sync, ואין צורך לגבות אותו; ה-volume של pgvector מחזיק את ה-embeddings של החיפוש בקבצים, שאובדים בלי pg_dump, ואז צריך להעלות את הקבצים מחדש. [8][9]

גרסה אחרונה

הגרסה האחרונה של הפרויקט

LibreChat 0.8.8 [23][24]

הפרופיל נבדק מול

LibreChat 0.8.8

הפרופיל נבדק מול הגרסה האחרונה.

נבדק ב-

14 באוק׳ 2026

מצב

נבדק ב-90 הימים האחרונים

איפה הגרסאות מתפרסמות

GitHub Releases

הגרסאות האחרונות של כל האפליקציות

גרסה

סטטוס הפרופיל

פורסם

נבדק מול גרסה

LibreChat 0.8.8

גרסת הפרופיל

1.0.0

המספרים אומתו

14 באוק׳ 2026

גרסת הקטלוג

2026.10.10

מדיניות sizing

2026.10.0

קובץ Compose

לא אומת

הפרויקט וחלופות

האתר הרשמי

www.librechat.ai

קוד מקור

github.com/LibreChat-AI/LibreChat

חלופות

Open WebUILobeHub

מקורות

1. Docker Docs: Control startup order in Compose (pg_isready healthcheck, service_healthy) (תיעוד רשמי · נקרא 11 באוק׳ 2026)
2. LibreChat v0.8.8 docker-compose.yml: api on 3080 (librechat-data at /app/data), mongo:8.0.20 --noauth, meilisearch v1.35.1, pgvector 0.8.0-pg15-trixie, rag_api lite, admin-panel (Compose רשמי · נקרא 14 באוק׳ 2026)
3. LibreChat v0.8.8 .env.example: PORT 3080, ALLOW_REGISTRATION=true, ALLOW_UNVERIFIED_EMAIL_LOGIN=true, OPENAI/ANTHROPIC/GOOGLE keys = user_provided, SEARCH=false, blank CREDS_* and JWT_* (מאגר רשמי · נקרא 14 באוק׳ 2026)
4. LibreChat docs: .env reference (CREDS_KEY 64 hex, CREDS_IV 32 hex, fixed values for production; blank ones are generated into a temp file; DOMAIN_CLIENT/DOMAIN_SERVER) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
5. LibreChat v0.8.8 packages/api/src/credentials.ts: startup refuses a CREDS_KEY that is not 64 hex or a CREDS_IV that is not 32 hex; blank values are generated into the temp credentials file (מאגר רשמי · נקרא 14 באוק׳ 2026)
6. LibreChat v0.8.8 api/server/index.js: GET /health returns 200 OK; PORT defaults to 3080; TRUST_PROXY defaults to 1 (מאגר רשמי · נקרא 14 באוק׳ 2026)
7. LibreChat v0.8.8 packages/api/src/oauth/csrf.ts: Secure cookies in production unless DOMAIN_SERVER is a localhost-style host (מאגר רשמי · נקרא 14 באוק׳ 2026)
8. LibreChat docs: Meilisearch (SEARCH=true plus a master key of 16+ bytes shared with the meilisearch service; keep port 7700 internal; reset-meili-sync) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
9. LibreChat docs: RAG API (lite image = remote embeddings only; OpenAI embeddings by default; RAG_OPENAI_API_KEY needed when OPENAI_API_KEY is user_provided) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
10. rag_api v0.9.0 app/config.py: RAG_PORT 8000, DB_HOST/DB_PORT/POSTGRES_* settings, RAG_OPENAI_API_KEY falls back to OPENAI_API_KEY, text-embedding-3-small, CHUNK_SIZE 1500, CHUNK_OVERLAP 100 (מאגר רשמי · נקרא 14 באוק׳ 2026)
11. rag_api v0.9.0 app/middleware.py: requests need a JWT signed with JWT_SECRET; without JWT_SECRET the check is skipped; /health is open (מאגר רשמי · נקרא 14 באוק׳ 2026)
12. Docker Official Image mongo: no authentication by default; MONGO_INITDB_ROOT_USERNAME/PASSWORD create a root user and start mongod --auth; mongosh is in the image; data in /data/db (תיעוד רשמי · נקרא 14 באוק׳ 2026)
13. Meilisearch API reference: GET /health returns 200 with status available (תיעוד רשמי · נקרא 14 באוק׳ 2026)
14. Meilisearch v1.35.1 Dockerfile: alpine:3.22 with curl and tini, no USER, WORKDIR /meili_data, EXPOSE 7700 (מאגר רשמי · נקרא 14 באוק׳ 2026)
15. Docker Official Image postgres 15/trixie Dockerfile: postgres user uid/gid 999, PGDATA and VOLUME /var/lib/postgresql/data, pg_isready (מאגר רשמי · נקרא 14 באוק׳ 2026)
16. GHCR librechat-ai/librechat:v0.8.8 (linux/amd64): 988,662,027 B compressed, 2,804,835,840 B decompressed and counted; config User node, no Healthcheck; layers contain usr/bin/wget (מדידה · נקרא 14 באוק׳ 2026)
17. LibreChat docs: Docker install (port 3080, first account becomes admin, MongoDB image needs AVX, update steps) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
18. LibreChat docs: deployment overview, minimum requirements 1 GiB RAM and 1 vCPU, 2 GB RAM suggested with everything enabled (תיעוד רשמי · נקרא 14 באוק׳ 2026)
19. LibreChat v0.8.8 Dockerfile: node:24.16.0-alpine, USER node, creates /app/client/public/images, /app/logs, /app/uploads, /app/data, EXPOSE 3080, CMD npm run backend (מאגר רשמי · נקרא 14 באוק׳ 2026)
20. LibreChat LICENSE: MIT (מאגר רשמי · נקרא 14 באוק׳ 2026)
21. LibreChat v0.8.8 data-schemas winston config: log files on by default, daily rotation, maxSize 20m, maxFiles 14d (מאגר רשמי · נקרא 14 באוק׳ 2026)
22. LibreChat v0.8.8 UPGRADING.md: tenant index migration for v0.8.7 and earlier databases (npm run migrate:tenant-indexes), Redis delta coalescing (Release notes · נקרא 14 באוק׳ 2026)
23. LibreChat v0.8.8 release notes (2026-09-30): retired JWT defaults refused (#15282), invalid AES credentials refused (#16402), credential defaults removed (#14680), tenant index migration (Release notes · נקרא 14 באוק׳ 2026)
24. LibreChat changelog: v0.8.8 (2026-09-30) is the newest release (Release notes · נקרא 14 באוק׳ 2026)
25. Docker: containerd image store is the default on fresh Engine 29+ installs and keeps images compressed and uncompressed (תיעוד רשמי · נקרא 10 באוק׳ 2026)
26. Node.js Docker image 24/alpine3.23 Dockerfile: user node with uid/gid 1000 (מאגר רשמי · נקרא 14 באוק׳ 2026)
27. MongoDB manual: WiredTiger cache defaults to the larger of 50% of (RAM - 1 GB) or 256 MB; set --wiredTigerCacheSizeGB when the container cannot use all host RAM (תיעוד רשמי · נקרא 14 באוק׳ 2026)
28. Docker Official Image mongo 8.0 Dockerfile: mongodb user uid/gid 999, VOLUME /data/db /data/configdb (מאגר רשמי · נקרא 14 באוק׳ 2026)
29. Docker Official Image mongo 8.0 docker-entrypoint.sh: as root, chowns /data/db and /data/configdb to mongodb and re-executes with gosu (מאגר רשמי · נקרא 14 באוק׳ 2026)
30. Docker Hub tag mongo:8.0.20 (linux/amd64): 312,915,385 B compressed; layers decompressed and counted: 957,032,960 B (מדידה · נקרא 14 באוק׳ 2026)
31. Meilisearch: Storage (LMDB never returns freed space; 9.1 MB JSON gave 224 MB on disk and ~305 MB RAM; RAM-to-disk 1/3, often 1/10, works well) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
32. Docker Hub tag getmeili/meilisearch:v1.35.1 (linux/amd64): 105,981,256 B compressed; layers decompressed and counted: 157,731,328 B (מדידה · נקרא 14 באוק׳ 2026)
33. Docker Hub tag pgvector/pgvector:0.8.0-pg15-trixie (linux/amd64): 159,295,182 B compressed (152 MiB); layers decompressed and counted: 455,663,616 B (מדידה · נקרא 14 באוק׳ 2026)
34. pgvector v0.8.0 README: each vector takes 4 × dimensions + 8 bytes (מאגר רשמי · נקרא 14 באוק׳ 2026)
35. OpenAI embeddings guide: text-embedding-3-small returns 1536-dimensional vectors (תיעוד רשמי · נקרא 14 באוק׳ 2026)
36. rag_api v0.9.0 README: EMBEDDING_BATCH_SIZE 500, EMBEDDING_MAX_QUEUE_SIZE 3, PARALLEL_EXECUTION 2 per upload; memory ≈ batch × (queue + parallel); smaller batches below 2 GB RAM (מאגר רשמי · נקרא 14 באוק׳ 2026)
37. rag_api v0.9.0 Dockerfile.lite: python:3.12-slim, no USER, WORKDIR /app, CMD python main.py (מאגר רשמי · נקרא 14 באוק׳ 2026)
38. GHCR manifest of librechat-ai/librechat-rag-api-dev-lite:v0.9.0 (linux/amd64): 539,995,713 B compressed; layers decompressed and counted: 1,659,485,184 B (מדידה · נקרא 14 באוק׳ 2026)
39. PostgreSQL 18 documentation: 19.4 Resource Consumption (תיעוד רשמי · נקרא 10 באוק׳ 2026)
40. PostgreSQL 18 documentation: 19.3 Connections and Authentication (תיעוד רשמי · נקרא 10 באוק׳ 2026)
41. PostgreSQL 18 documentation: 19.10 Vacuuming (autovacuum settings) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
42. PostgreSQL 18 documentation: 19.5 Write Ahead Log (max_wal_size) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
43. PostgreSQL 18 documentation: 51.2 How Connections Are Established (תיעוד רשמי · נקרא 10 באוק׳ 2026)
44. Docker Official Image postgres: documentation (docker-library/docs) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
45. Docker Hub: library/postgres tag 18.6 (compressed image sizes) (מאגר רשמי · נקרא 10 באוק׳ 2026)