SSD Nodes Learn Hosting plans →
מדריכים Matt Connorמאת Matt Connor · עודכן 2026-10-25

אירוח עצמי של LiveContext: חלופת n8n

מדריך מעשי ל־LiveContext CE: מחסנית Docker בת שבע מכולות, backend של Java שדורש 8 GB RAM, נעילת גרסה, Traefik וגיבוי לשני מאגרי הנתונים.

מהו LiveContext ומה עלות ההפעלה שלו

כדי לארח את LiveContext בעצמכם, דרוש לכם VPS עם כ־8 GB RAM. LiveContext CE היא פלטפורמת אוטומציה שזמינה עם קוד המקור שלה, ומפעילה סוכני AI בתוך תהליך האוטומציה עצמו. היא מופצת כמחסנית Docker Compose הכוללת שבע מכולות, הבנויות סביב backend של Java. אחת מהן היא משימת one shot שמסתיימת לאחר ההתקנה. תיעוד האירוח העצמי של הספק דורש 4 GB לכל הפחות וממליץ על 8 GB. קובץ ה־README של מפעיל ה־npm מציין כעת 6 GB לכל הפחות, וקובץ ה־compose מראה כיצד הזיכרון מתחלק.

הפרויקט פורסם כ־livecontext-ai/livecontext-ce ב־GitHub תחת AGPL-3.0, אך CE אינה עוד תחת AGPL. הרישיון המצורף למהדורה הנוכחית הוא LiveContext Sustainable Use License 1.1, רישיון שזמין עם קוד המקור ומאפשר להפעיל ולשנות את CE, כולל בסביבת production בתוך העסק שלכם. עם זאת, הוא אוסר להציע אותה לצדדים שלישיים כשירות hosted או embedded, אם הדבר נועד להתחרות בגרסאות בתשלום של LiveContext. מפעיל ה־npm של הספק מציג את השינוי: livecontext@0.2.11 מצהיר על AGPL-3.0-only, ואילו livecontext@0.3.8 מפנה לקובץ הרישיון. נכון ל־13 באוקטובר 2026, מאגר GitHub והארגון livecontext-ai מחזירים שניהם 404, אף שתיעוד הספק עדיין מורה לשכפל את המאגר. לכן המדריך הזה משתמש בקובצי המהדורה מתוך חבילת ה־npm. המהדורה הנוכחית היא v0.3.8, והיא פורסמה ב־9 באוקטובר 2026. כל תמונת LiveContext נבנית עבור linux/amd64 בלבד, ולכן התוכניות הזולות המבוססות על Arm אינן מתאימות. במדריך הזה נעגן את ה־tag הזה, נציב את המחסנית מאחורי reverse proxy, ונמיר את המלצות הגיבוי של הפרויקט המקורי לפקודות.

תכננו את משאבי ה־VPS לפני אירוח עצמי של LiveContext

לרוב השירותים בקובץ ה־compose שסופק מוגדרת מגבלת זיכרון מפורשת, ולכן אפשר לתכנן את השרת לפני ששוכרים אותו. לשני שירותים אין מגבלה כזאת: משימת minio-init החד־פעמית וה־frontend. אלה המגבלות הכתובות בקובץ ה־compose של v0.3.8, ולא שימוש שנמדד בפועל.

תרשיםMemory limits in the LiveContext CE v0.3.8 compose file, MB
הנתונים שמאחורי התרשים
[
  {
    "label": "livecontext (backend)",
    "memory_limit_mb": 2048
  },
  {
    "label": "bridge",
    "memory_limit_mb": 512
  },
  {
    "label": "postgres",
    "memory_limit_mb": 512
  },
  {
    "label": "redis",
    "memory_limit_mb": 384
  },
  {
    "label": "minio",
    "memory_limit_mb": 256
  },
  {
    "label": "websearch (optional)",
    "memory_limit_mb": 2048
  },
  {
    "label": "searxng (optional)",
    "memory_limit_mb": 512
  },
  {
    "label": "renderer (optional)",
    "memory_limit_mb": 1024
  }
]

ל־backend לבדו מוגדרת תקרה של 2048 MB. תקרה זו חלה על תהליך Java 21 שה־heap שלו מוגדר ל־1 GiB (-Xmx1024m עם ZGC), ובהערה בקובץ ה־compose מצוין שה־heap גדל למלוא ה־GiB הזה, נוסף על התקורה של ה־JVM עצמו. לחמשת שירותי הבסיס עם מגבלות יש יחד כ־3.6 GB, ול־frontend אין מגבלה כלל, ולכן הוא צורך את כמות הזיכרון ש־Node מבקש. ב־VPS בנפח 4 GB, המגבלות האלה לבדן משאירות כמה מאות MB בלבד עבור ה־frontend, ה־kernel ו־page cache. לכן קובץ ה־README של ה־launcher מציין כעת מינימום של 6 GB, אף על פי שבמסמכי האירוח העצמי עדיין מצוין 4 GB.

ה־profiles האופציונליים הם שמעלים את הדרישה ל־8 GB. ה־profile של browser agent מוסיף מכולת Chromium עם תקרה של 2048 MB, לצד מופע חיפוש של SearXNG, וה־profile של renderer מוסיף 1024 MB נוספים עבור צילומי מסך ו־PDF. אף אחד מהם אינו מופעל בלי שתפעילו את ה־profile המתאים, ולכן השאירו את שניהם כבויים עד שתזדקקו להם. מכולת Chromium נבנית מקומית מתוך תיקיית websearch-service שאינה נכללת בחבילת npm. לכן, כאשר מאגר GitHub אינו נגיש, אי אפשר לבנות את ה־profile של browser agent מהקבצים שפורסמו, נכון ל־13 October 2026. ה־renderer משתמש ב־image שפורסם, ולכן אינו מושפע מכך. מכולת SearXNG זו קיימת כדי לשמש כ־backend החיפוש של ה־agent. לכן הדפים שהיא מחזירה מגיעים ל־prompts שלכם כטקסט בלתי מהימן. זהו גבול האמון שדרכו פועל מתן חיפוש Web באמצעות SearXNG ל־AI agent בפירוט.

אם אתם כבר מריצים n8n, תכננו להחליף אותו במקום להוסיף את LiveContext לצדו. ה־stack שב־מדריך שלנו להרצת n8n על VPS באמצעות Docker ו־HTTPS כולל תהליך Node אחד לצד Postgres, והוא פועל היטב על שרת קטן. LiveContext מקצה ל־backend שלו לבדו יותר משכל ה־stack הזה צורך. שתי פלטפורמות אוטומציה על VPS בנפח 8 GB יפעלו יחד עד לרגע שבו שתיהן יריצו משימה באותה דקה. אם אתם משתפים את השרת, הגדירו מגבלות מפורשות גם לכל שאר הרכיבים, באמצעות השיטה שב־המאמר שלנו על הגדרת מגבלות זיכרון ב־Docker Compose, כדי ש־workflow אחד שיצא משליטה לא ישבית יחד איתו את כל המכונה.

התקנת LiveContext באמצעות Docker Compose עם קיבוע לתג

התחילו מ־VPS נקי של Ubuntu 24.04, עם Docker Engine 24 ואילך ו־Compose v2. אם Docker עדיין אינו מותקן, פעלו תחילה לפי המדריך שלנו ליסודות Docker Compose עבור VPS, ולאחר מכן חזרו לכאן.

README של ה־launcher מציע את npx livecontext@latest כפקודת הפעלה בשורה אחת. זה מתאים למחשב נייד, אך ה־launcher מעתיק מחדש את קובץ ה־compose בכל הפעלה, והתמונות שהוא מציין מסומנות ב־latest. בשרת רצוי שקובץ ה־compose יישמר בתיקייה שבשליטתכם ויהיה מקובע לגרסה אחת, כך ששדרוג יהיה שינוי בקובץ שאפשר להשוות. תיעוד הספק עדיין מתאר git clone של מאגר GitHub לשם כך, אך המאגר מחזיר 404 נכון ל־13 באוקטובר 2026. לכן הורידו את אותם שני קבצים, קובץ ה־compose וקובץ הסביבה לדוגמה, מחבילת npm של הגרסה הרצויה.

sudo apt update && sudo apt install -y npm
npm view livecontext version
mkdir -p ~/livecontext-ce/docker ~/livecontext-ce/catalog-seeds
cd ~/livecontext-ce
npm pack livecontext@0.3.8
tar xzf livecontext-0.3.8.tgz
cp package/assets/docker-compose.yml .
cp package/assets/.env.example docker/.env.ce
chmod 600 docker/.env.ce

קובץ ה־compose ממפה את ./catalog-seeds אל ה־backend, ולכן התיקייה נוצרת קודם לכן. ה־launcher של npm ממלא אותה בחבילת קטלוג מודלים שהוא מוריד בעת ההפעלה, וה־stack מופעל כשהיא ריקה.

קובץ ה־compose שבחבילת npm מציין לכל תמונות LiveContext את התג latest, לדוגמה ghcr.io/livecontext-ai/livecontext-ce:latest, אף שבהערת הכותרת שלו מצוין שהתג מקובע לגרסה. קבעו אותו בעצמכם לפני ההפעלה הראשונה. הספק מפרסם את אותם תגי גרסה ב־Docker Hub תחת מרחב השמות livecontext. נכון ל־13 באוקטובר 2026, v0.3.8 הופיע עבור תמונות ה־backend, ה־frontend, ה־bridge וה־renderer. לכן הגדירו שם את ארבע התמונות:

sed -i -E 's#ghcr\.io/livecontext-ai/(livecontext-ce[a-z-]*):latest#livecontext/\1:v0.3.8#' docker-compose.yml
grep -n 'image:' docker-compose.yml

נטילת קובץ ה־compose מאותה גרסה כמו התמונות היא ששומרת על התאמה ביניהן, משום שקובץ ה־compose עבור v0.3.8 נכתב עבור התמונות האלה. אל תשאירו את התגים על latest. תג latest עשוי להשתנות ללא התראה, וה־backend מריץ מיגרציות של מסד הנתונים בכל הפעלה. לכן משיכה מקרית עלולה לקדם את הסכמה בשעה 3 לפנות בוקר, בלי אפשרות לחזור לאחור אלא באמצעות שחזור.

ערכו את docker/.env.ce לפני ההפעלה הראשונה (הסעיף הבא מפרט מה יש לשנות), ולאחר מכן הפעילו את ה־stack.

docker compose --env-file docker/.env.ce up -d
docker compose --env-file docker/.env.ce ps

השתמשו באותו דגל --env-file בכל פקודת compose במדריך הזה. Compose קורא את הקובץ מחדש בכל הפעלה, ולכן פקודה ללא הדגל תחזור לברירות המחדל המוטמעות בקובץ ה־compose ועלולה לפרסם פורטים שונים מאלה שהגדרתם.

ל־healthcheck של ה־backend מוגדר start_period של 120s, והוא בודק את /actuator/health. לכן docker compose ps מדווח ששירות livecontext הוא health: starting במשך כשתי הדקות הראשונות, בזמן שמיגרציות הסכמה ורישום הכלים מתבצעים. זה תקין. בדיקה מהירה מהשרת:

curl -s localhost:8080/actuator/health

הפקודה אמורה להדפיס {"status":"UP"}. לאחר מכן פתחו את ממשק האינטרנט בפורט 3000. החשבון הראשון שתיצרו יהפוך לחשבון מנהל, ולאחר מכן ההרשמה הציבורית נסגרת, אלא אם מנהל פותח אותה מחדש. לכן צרו את החשבון שלכם לפני שהפורט יהיה נגיש למשתמשים אחרים. זו הסיבה החשובה ביותר שלא לפרסם את פורט 3000 באינטרנט כבר ביום הראשון.

ערכי הסביבה שעליכם לשנות

קובץ הדוגמה כולל ערכי ברירת מחדל פעילים, כדי שה־stack יופעל במחשב נייד. כמה מהם אינם בטוחים בשרת ציבורי.

DB_PASSWORD=<random>
MINIO_ROOT_USER=<not minioadmin>
MINIO_ROOT_PASSWORD=<random>
CREDENTIAL_ENCRYPTION_PASSWORD=<random>
CREDENTIAL_ENCRYPTION_SALT=<random>
ANTHROPIC_API_KEY=sk-ant-...
FRONTEND_PORT=3000
BACKEND_PORT=8080
PUBLIC_BASE_URL=https://lc.example.com
GATEWAY_PUBLIC_URL=https://lc-api.example.com

צרו כל ערך אקראי באמצעות openssl rand -base64 32. שימו לב במיוחד לערכים הבאים:

  • DB_PASSWORD ו־MINIO_ROOT_PASSWORD מגיעים עם ערכי ברירת המחדל postgres ו־minioadmin. קובץ ה־compose מעביר את DB_PASSWORD ל־Postgres כ־POSTGRES_PASSWORD שלו. אף אחד מפורטי מסד הנתונים אינו מפורסם אל ה־host, ולכן הם אינם חשופים ישירות. עם זאת, כל container שתחברו בהמשך לאותה רשת יוכל לגשת לשניהם באמצעות ברירת המחדל המתועדת.
  • CREDENTIAL_ENCRYPTION_PASSWORD ו־CREDENTIAL_ENCRYPTION_SALT מגיעים כשהם בהערה, וכאשר משאירים אותם ריקים הם נוצרים אוטומטית באתחול הראשון. הגדירו אותם בעצמכם במקום זאת. פרטי האימות שה־workflows שלכם שומרים מוצפנים באמצעות צמד הערכים הזה. לכן, dump של מסד נתונים ששוחזר במחשב חדש בלי אותה סיסמה ובלי אותו salt יכיל שורות של פרטי אימות שאי אפשר לקרוא. הגדירו אותם פעם אחת, ולאחר מכן התייחסו אל docker/.env.ce כחלק מהגיבוי.
  • FRONTEND_PORT ו־BACKEND_PORT משובצים במיפויי הפורטים כ־${FRONTEND_PORT:-3000}:3000 ו־${BACKEND_PORT:-8080}:8080. בקובץ הסביבה לדוגמה שני הערכים מופיעים בהערה, כ־# FRONTEND_PORT=3000 ו־# BACKEND_PORT=8080. לכן ברירות המחדל 3000 ו־8080 חלות עד שתסירו את סימן ההערה משורה כדי לשנות אותן.
  • PUBLIC_BASE_URL הוא הכתובת של ממשק המשתמש באינטרנט, והקובץ לדוגמה מבקש שבהתקנות בשרת תגדירו אותו לצד GATEWAY_PUBLIC_URL. כתבו את שני הערכים ללא לוכסן בסוף, משום שהקובץ לדוגמה מזהיר שלוכסן כזה משבש את קריאות החזרה של OAuth.
  • GATEWAY_PUBLIC_URL הוא המקור של ה־backend כפי שהוא נראה בדפדפן. הוא חשוב מרגע שמעורב reverse proxy. עיינו בסעיף הבא.
  • מפתחות המודלים (ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_API_KEY, ובאופן אופציונלי MISTRAL_API_KEY או DEEPSEEK_API_KEY) נשמרים כאן כטקסט גלוי. מלאו רק את הערך של הספק שבו אתם משתמשים בפועל.

מה עושים שבעת הקונטיינרים

  • postgres מפעיל את pgvector/pgvector:pg16 בקונטיינר livecontext-db, שמכיל את מסד הנתונים בשם livecontext. ההרחבה pgvector משמשת לחיפוש embeddings, ולכן image רגיל של postgres:16 לא יספיק.
  • redis מפעיל את redis:7-alpine עם appendonly yes ו־--maxmemory-policy noeviction. זו מדיניות מכוונת: Redis מחזיק כאן את מצב התורים וההרצות, ולכן כאשר הוא מגיע לתקרת הזיכרון, הוא מחזיר שגיאה לכותב במקום להשמיט מפתחות בשקט. שגיאה שניתן לראות עדיפה על עבודה שנעלמת.
  • minio הוא מאגר האובייקטים תואם־S3 עבור קבצים שעוברים בין workflows.
  • minio-init הוא קונטיינר חד־פעמי שמריץ את mc mb myminio/workflow-files --ignore-existing בעת האתחול, יוצר את ה־bucket ויוצא. הופעת minio-init כ־exited (0) בתוך docker compose ps היא המצב התקין.
  • bridge מכיל את מתאמי ה־CLI ואת כלי ה־MCP (פרוטוקול הקשר של המודל). הוא מאזין ב־8093 בתוך רשת Docker ואינו מפורסם למארח.
  • livecontext הוא ה־backend, מונולית Java 21 יחיד בפורט 8080. הוא מפעיל את מנוע ה־workflow, את המתזמנים ואת הסוכנים.
  • frontend הוא ממשק המשתמש מבוסס Next.js בפורט 3000. רק שני הקונטיינרים האחרונים האלה מפורסמים למארח.

המצב נשמר בשבעה volumes בעלי שמות: livecontext_data עבור Postgres, וכן livecontext_redis, livecontext_minio, livecontext_keys, livecontext_bridge_secret, livecontext_cli_home ו־livecontext_logs. Compose מוסיף להם קידומת של שם הפרויקט, שקובץ ה־compose מגדיר כ־livecontext-ce, ולכן ה־volume בפועל בדיסק נקרא בשם כגון livecontext-ce_livecontext_minio. משגר ה־npm עוקף את השם הזה ומגדיר במקומו את -p livecontext, ולכן שרת שהריץ בעבר את npx livecontext מכיל קבוצת volumes נוספת עם הקידומת livecontext_. הריצו את docker volume ls והעתיקו את השמות המדויקים לפני שתכתבו script כלשהו לגיבוי שלהם.

docker compose down -v מוחק את כל שבעת ה־volumes. בתיעוד הספק נאמר שאסור להריץ אותו, משום שזו הדרך המהירה ביותר לאבד את כל ה־workflows שבניתם. -v הוא כל ההבדל.

העבירו אותו מאחורי Traefik במקום לפרסם את פורט 3000

פרסום הפורטים 3000 ו־8080 ב־VPS ציבורי חושף את היישום ללא TLS (אבטחת שכבת התעבורה) וללא שכבת הגנה לפני רישום מנהלי מערכת. כלל ufw אינו מספיק בפני עצמו, משום ש־Docker מוסיף כללי iptables משלו עבור פורטים שפורסמו, לפני השרשרת ש־ufw מנהל. לכן פורט שפורסם אל 0.0.0.0 נשאר נגיש גם כאשר ufw מציין שהפורט חסום.

הפתרון הנכון הוא לא לפרסם פורטים כלל, ולאפשר ל־proxy לגשת למכולות דרך רשת Docker משותפת. צרו את docker-compose.override.yml לצד docker-compose.yml:

services:
  frontend:
    ports: !override []
    networks:
      - default
      - proxy
  livecontext:
    ports: !override []
    networks:
      - default
      - proxy

networks:
  proxy:
    external: true

שני פרטים קובעים אם הדבר יעבוד. !override מחליף את רשימת הפורטים במקום למזג אותה, ולכן נדרש Compose v2.24 או חדש יותר. בדקו זאת באמצעות docker compose version, משום שבגרסת Compose ישנה יותר שתי הרשימות מתמזגות והפורטים נשארים מפורסמים. בנוסף, default חייב להישאר בכל רשימת networks, משום ששמות של רשת כלשהי מחליפים את רשת ברירת המחדל. השמטת הרשת מנתקת את ה־backend מ־Postgres ומ־Redis, ואת ה־frontend מה־backend. אשרו את התוצאה הממוזגת לפני הפעלת דבר כלשהו:

docker compose --env-file docker/.env.ce config

ה־routers, מנהל האישורים וההפניה מ־HTTP ל־HTTPS זהים לאלה של כל יישום אחר. לכן פעלו לפי מדריך ה־reverse proxy שלנו ל־Traefik להפעלת כמה יישומים על VPS אחד, במקום לכתוב כאן תצורת TLS חדשה. נָתבו שם מתחם אחד אל frontend בפורט 3000, ושם מתחם שני אל livecontext בפורט 8080.

שם המתחם השני אינו אפשרות. ממשק האינטרנט קורא ל־backend מהדפדפן, ולכן ה־backend זקוק ל־origin משלו, שהדפדפן יכול לגשת אליו. הגדירו את GATEWAY_PUBLIC_URL בתוך docker/.env.ce לכתובת ה־backend הזו, לדוגמה https://lc-api.example.com, ואת PUBLIC_BASE_URL לכתובת ה־frontend. אם תדלגו על כך, הדף ייטען כרגיל אך כל פעולה תיכשל, משום שה־UI הסיק את כתובת ה־origin של ה־backend מהכתובת שפתחתם, וקורא לפורט שה־proxy מעולם לא פרסם.

מכיוון שדף ההרשמה פתוח לכל מי שמגיע אליו ראשון, כדאי להוסיף forward auth ל־frontend router, כדי שאיש לא יראה את הדף בלי לבצע אימות ב־proxy. זה מה שמוסיף הפעלת Authentik כשכבת ה־SSO העצמאית שלכם על גבי אותה תצורת Traefik.

היכן מגדירים את מפתח המודל, ומדוע גם מופע לא פעיל עדיין עולה כסף

סוכנים פועלים בתוך מנגנון האוטומציה כאן, ולכן כלכלת השימוש שונה מזו של כלי workflow רגיל. מפתח הספק נמצא ב־docker/.env.ce כ־ANTHROPIC_API_KEY או כ־OPENAI_API_KEY, נקרא על ידי ה־backend וה־bridge בעת האתחול, וחל על המופע כולו. הוא אינו מוגבל למשתמש מסוים. כל מי שיש לו חשבון במופע שלך ויכול לבנות סוכן משתמש במפתח הזה, והאדם הראשון שנרשם הוא מנהל. אם דרושים לך סוכנים נפרדים לכל אדם והוצאות שאפשר לייחס בפועל לעמית מסוים, אירוח עצמי של OneCLI כמסגרת לסוכן אחד לכל אדם פותר את אותה בעיית מפתחות מכיוון אחר: כל מפתח מודל עובר דרך gateway שיודע מי מבצע את הקריאה.

שלושה הרגלים עוזרים לשמור על חשבון צפוי. צרו מפתח ספק נפרד עבור ה־VPS הזה, כדי שתוכלו לבטל אותו בלי להשפיע על דבר אחר. הגדירו תקרת הוצאה קשיחה במסוף הספק, משום שזו המגבלה היחידה הנמצאת מחוץ למכונה שעליה אתם מגינים. לאחר מכן השתמשו בתקציבי האשראי לכל סוכן ובמדדים לכל סוכן ש־LiveContext מציג, כדי שלולאה יחידה לא תרוקן את המפתח לפני שתבחינו בכך.

עלות של מופע לא פעיל אינה אפסית לאחר שסוכן מוגדר לפי לוח זמנים. טריגר של לוח זמנים מופעל בין שאיש עוקב אחריו ובין שלא, וכל הפעלה שולחת אסימונים. לוח זמנים של חמש דקות מייצר 288 הרצות ביום, וגם סוכן שקורא דף ומחליט לא לעשות דבר עדיין מחויב על קריאת הדף. הגדירו את הסוכנים הראשונים באמצעות webhook או טריגר צ'אט, עקבו אחר ההוצאה בפועל במשך שבוע, ועברו ללוח זמנים רק לאחר שתדעו מהי העלות לכל הרצה.

גיבוי Postgres ו־object store

קיימים שני מאגרי נתונים ושני מקומות שבהם נשמרים secrets: קובץ ה־env וה־volume של livecontext_keys, שהיצרן מציין ברשימת ה־volumes שיש לגבות. אובדן של אחד מהם גורם לאובדן ה־instance. גבה את מסד הנתונים ואת ה־bucket באותו חלון זמן, כאשר ה־backend מופסק, כדי שלא ניתן יהיה לכתוב קובץ לאחר שהשורה המתאימה במסד הנתונים כבר נכללה ב־dump.

cd ~/livecontext-ce
mkdir -p ~/backups
docker compose --env-file docker/.env.ce stop livecontext frontend
docker compose --env-file docker/.env.ce exec -T postgres \
  pg_dump -U postgres -d livecontext --clean --if-exists \
  | gzip > ~/backups/livecontext-db-$(date +%F).sql.gz

השתמש בכל ערך שהגדרת עבור DB_USERNAME במקום postgres, אם שינית אותו. לאחר מכן העתק את ה־volumes של ה־object store ושל ה־keys, באמצעות השמות עם הקידומת שהציג docker volume ls:

docker run --rm \
  -v livecontext-ce_livecontext_minio:/data \
  -v ~/backups:/backup \
  alpine tar czf /backup/livecontext-minio-$(date +%F).tgz -C /data .
docker run --rm \
  -v livecontext-ce_livecontext_keys:/data \
  -v ~/backups:/backup \
  alpine tar czf /backup/livecontext-keys-$(date +%F).tgz -C /data .
docker compose --env-file docker/.env.ce start livecontext frontend
cp docker/.env.ce ~/backups/env.ce.$(date +%F)

בדוק שה־dump אינו ריק לפני שתסתמך עליו: gunzip -c ~/backups/livecontext-db-*.sql.gz | head -20 אמור להציג פקודות CREATE TABLE ו־DROP TABLE, ולא שגיאה שמופיעה בשורה אחת. לאחר מכן העתק את כל ארבעת הקבצים אל מחוץ לשרת, יחד עם docker-compose.yml ועם קובץ ה־override שלך. גיבוי שנמצא רק במחשב שעליו הוא מגן אינו גיבוי.

כדי לשחזר לשרת חדש, התקן את אותו tag, החזר את docker/.env.ce שנשמר כך שסיסמת ההצפנה וה־salt של פרטי הגישה יתאימו, הפעל את ה־stack פעם אחת כדי שה־volumes ייווצרו, עצור את ה־backend, חלץ את ארכיון ה־keys אל ה־volume של ה־keys באותה דרך שבה הוא נאסף, ולאחר מכן טען את ה־dump:

gunzip -c livecontext-db-2026-08-10.sql.gz \
  | docker compose --env-file docker/.env.ce exec -T postgres psql -U postgres -d livecontext

שדרוגים וחזרה לאחור במקרה של תקלה

צרו dump תחילה, בכל פעם. ה־backend מחיל את מיגרציות הסכמה שלו בעת האתחול, והמיגרציות מתקדמות בכיוון אחד בלבד. לכן, חזרה ל־tag ישן לאחר שדרוג כושל משאירה קוד ישן שרץ מול סכמה חדשה. rollback משמעותו שחזור ה־dump, ולכן ה־dump נוצר ראשון.

cd ~/livecontext-ce
npm view livecontext version
TAG=0.3.8
npm pack "livecontext@$TAG"
rm -rf package && tar xzf "livecontext-$TAG.tgz"
cp docker-compose.yml docker-compose.yml.prev
cp package/assets/docker-compose.yml .
sed -i -E "s#ghcr\.io/livecontext-ai/(livecontext-ce[a-z-]*):latest#livecontext/\1:v$TAG#" docker-compose.yml
diff docker-compose.yml.prev docker-compose.yml
docker compose --env-file docker/.env.ce pull
docker compose --env-file docker/.env.ce up -d
docker compose --env-file docker/.env.ce logs -f livecontext

הגדירו את TAG לגרסה שהודפסה בפלט של הפקודה השנייה. עקבו אחר הלוג של ה־backend עד ש־health endpoint עונה שוב. ה־docker-compose.override.yml שלכם אינו חלק מהחבילה, ולכן העתקת קובץ ה־compose החדש משאירה אותו במקומו. עם זאת, קראו את ה־diff שהפקודה diff מדפיסה, משום ששירות חדש או שירות ששמו השתנה עלולים להפוך את קובץ ה־override שלכם למיושן בלי להציג הודעת שגיאה. השוו גם בין docker/.env.ce לבין package/assets/.env.example, משום שהגדרות חדשות מתווספות שם.

מצבי כשל והטקסטים שיופיעו

מכולה ממשיכה לבצע restart ו־docker compose ps מציג exited (137). זהו מנגנון ה־out-of-memory killer של ליבת המערכת, ו־docker inspect livecontext-app מאשר זאת באמצעות "OOMKilled": true בבלוק המצב. ה־backend הגיע למגבלת הזיכרון של המכולה, 2048M, או שהמארח אזל מזיכרון קודם לכן. בדקו את free -m לפני הגדלת מגבלה כלשהי, משום שהגדלת מגבלת מכולה במארח שאין בו זיכרון פנוי רק מעבירה את פעולת ההריגה למכולה אחרת.

ה־pull נכשל עם no matching manifest for linux/arm64/v8 in the manifest list entries. התמונות זמינות עבור linux/amd64 בלבד. VPS מבוסס Arm אינו יכול להריץ את ה־stack הזה מהתמונות שפורסמו, והרצה באמצעות אמולציה דרך QEMU איטית מדי עבור JVM יחד עם Chromium. עברו לתוכנית x86.

Bind for 0.0.0.0:3000 failed: port is already allocated. תהליך אחר במארח כבר משתמש בפורט הזה. הגדירו את FRONTEND_PORT בתוך docker/.env.ce, או החילו את העקיפה שלעיל ואל תפרסמו דבר כלל.

הממשק פעיל, אך בקשת ההתחברות נכשלת לאחר הוספת ה־proxy. הדפדפן פונה ל־backend דרך origin שה־proxy שלכם אינו משרת. פתחו את לשונית הרשת בדפדפן ובדקו את ה־host של הבקשה שנכשלה. הגדירו את GATEWAY_PUBLIC_URL לכתובת הציבורית של ה־backend וצרו מחדש את מכולת ה־frontend, משום שהערך הזה נקרא בעת האתחול.

הכול תקין, אך קבצים שהועלו בתהליך עבודה נעלמים. בדקו ש־minio-init מציג exited (0) ולא קוד שאינו אפס. אם ה־bucket workflow-files מעולם לא נוצר, אין ל־backend מקום לאחסן בו אובייקטים.

בחירה בין LiveContext לבין n8n

בחרו ב־LiveContext כאשר הסוכן הוא מוקד העבודה: אתם רוצים שהמודל יבנה ויריץ את האוטומציה, ומקבלים שרת בנפח 8 GB ושירות Java כמחיר לכך. בחרו ב־n8n כאשר אתם רוצים workflows דטרמיניסטיים, ספריית nodes גדולה וטביעת משאבים שמאפשרת לשתף VPS עם שירותים אחרים. הרישיונות כבר אינם מפרידים בין שני המוצרים. LiveContext CE עבר מ־AGPL-3.0 ל־LiveContext Sustainable Use License 1.1, רישיון זמין בקוד המקור מאותה משפחת fair-code כמו רישיון Sustainable Use License של n8n, לכן קראו את מגבלת האירוח לפני שתציעו אחד מהמוצרים למישהו מחוץ לחברה. גם n8n באירוח עצמי מגביל כמה תכונות ללקוחות משלמים, לכן בדקו אילו חלקים של n8n זמינים בחינם ואילו דורשים מפתח רישיון לפני שתבנו workflow צוותי סביב אחד מהם. מספרי הגרסאות כאן עדיין צעירים, v0.3.8 נכון ל־13 באוקטובר 2026, ובסדרת 0.3 שוחררו תשע גרסאות בין 22 בספטמבר ל־9 באוקטובר 2026, לכן קבעו את הגרסה וקראו מה השתנה לפני כל שדרוג. לסקירה רחבה יותר של התחום, כולל כלים שנמצאים בין שתי האפשרויות האלה, ראו את הסקירה שלנו על חלופות n8n באירוח עצמי במקום לקרוא השוואה של שני המוצרים האלה בלבד.

FAQ

כמה RAM נדרש עבור LiveContext באירוח עצמי?

תכננו עבור 8 GB. בתיעוד של הספק לאירוח עצמי מצוינים 4 GB כמינימום ו־8 GB כהמלצה, בקובץ ה־README של ה־launcher מצוינים כעת 6 GB כמינימום, ובקובץ ה־compose שסופק מוסבר מדוע: ל־backend לבדו מוגבלת צריכת הזיכרון ל־2048 MB, וחמשת שירותי הבסיס עם המגבלות שלהם צורכים יחד כ־3.6 GB, עוד לפני מכל ה־frontend שאין לו מגבלה. הפעלת פרופיל סוכן הדפדפן מוסיפה 2048 MB נוספים עבור Chromium, וכן מכל SearXNG, ולכן בשלב זה 8 GB כבר אינם בגדר אפשרות בלבד.

האם אפשר להפעיל את LiveContext ב־VPS מבוסס Arm?

לא. כל תמונת LiveContext שפורסמה עבור v0.3.8 נבנתה עבור linux/amd64, ולכן docker compose up בחבילת Arm נכשל בעת המשיכה ומציג no matching manifest for linux/arm64/v8 in the manifest list entries. תאורטית אפשר להפעיל אותו באמצעות אמולציית QEMU, אך בפועל הדבר אינו שמיש עבור עומס עבודה של JVM. בחרו בחבילת x86.

היכן מזינים את מפתח ה־API של המודל?

ב־docker/.env.ce, בתור ANTHROPIC_API_KEY, OPENAI_API_KEY או GOOGLE_API_KEY, לפני ההפעלה הראשונה. ה־backend וה־bridge קוראים את הערך בעת האתחול, והוא חל על המופע כולו ולא על משתמש יחיד. השאירו את הקובץ בהרשאה 600, השתמשו במפתח שנוצר רק עבור השרת הזה כדי שתוכלו לבטל אותו בנפרד, והגדירו תקרת הוצאה במסוף של הספק, משום שזו המגבלה היחידה שנמצאת מחוץ למכונה.

כיצד מגבים את LiveContext?

ארבעה דברים: pg_dump של מסד הנתונים livecontext, עותק של אמצעי האחסון של MinIO, עותק של אמצעי האחסון של livecontext_keys, והקובץ docker/.env.ce. עצרו את שירותי livecontext ו־frontend בזמן יצירת ה־dump והעתקת אמצעי האחסון, כדי שמסד הנתונים ואחסון האובייקטים יהיו מסונכרנים זה עם זה. קובץ ה־env חשוב משום שפרטי הגישה המאוחסנים ב־workflows מוצפנים באמצעות CREDENTIAL_ENCRYPTION_PASSWORD ו־CREDENTIAL_ENCRYPTION_SALT, ולכן שחזור ללא הערכים האלה ישאיר רשומות של פרטי גישה שאף רכיב במכונה החדשה לא יוכל לקרוא.

מדוע ה־backend נשאר ב־health: starting במשך דקות לאחר האתחול?

בדיקת התקינות של ה־compose מגדירה את start_period: 120s ובודקת את /actuator/health במחזוריות, ולכן Docker מדווח שהשירות נמצא בתהליך ההפעלה בזמן שהגירות הסכמה ורישום הכלים מתבצעים. שתי דקות עד שלוש דקות באתחול הראשון הן זמן צפוי. אם השירות אינו עובר לעולם למצב תקין, קראו את docker compose logs -f livecontext. מחסנית שנעצרת בשלב ההגירה מצביעה בדרך כלל על כך שהיא מחוברת לאמצעי אחסון של מסד נתונים מגרסה חדשה יותר.

האם המאמר הזה היה מועיל?