התקנת Chatwoot על שרת VPS באמצעות Docker
מדריך מעשי להקמת Chatwoot עם Docker Compose ו-Traefik. למדו כיצד להגדיר SMTP תקין, לבצע גיבויים ל-Postgres, לנהל שדרוגים בטוחים ולפתור שגיאות כמו extension vector.
מה אתם בונים
כדי לארח Chatwoot באופן עצמי על גבי VPS, עליכם להריץ ארבע מכולות: תהליך Rails web, עובד רקע Sidekiq, מסד נתונים PostgreSQL עם הרחבת pgvector, ו־Redis. Chatwoot הוא פתרון קוד פתוח לניהול תמיכת לקוחות, כך שתקבלו תיבת דואר נכנס משותפת לצוות ווידג'ט צ'אט לאתר על שרת שבשליטתכם. ההתקנה אורכת כעשרים דקות. כל מה שבא לאחר מכן – משלוח דואר, גיבויים, שדרוגים והתאמת משאבים – הוא שיקבע אם המערכת תמשיך לפעול גם בעוד שנה.
לכל מכולה תפקיד אחד. Rails מגיש את לוח הבקרה של הנציגים ואת ה־API (ממשק תכנות יישומים) של הווידג'ט. Sidekiq מבצע את המשימות האיטיות: שליחת דואר אלקטרוני, תשאול ערוצים מחוברים, הרצת חוקי אוטומציה והפקת דוחות. Postgres מאחסן את השיחות, אנשי הקשר, חשבונות הנציגים וכל הגדרה שתשנו בלוח הבקרה. Redis מחזיק את התורים של Sidekiq ואת ערוץ ה־pub/sub של ActionCable, שדוחף הודעות חדשות ללוח בקרה פתוח ללא צורך בטעינה מחדש של הדף. Redis אינו משמש כאן כמטמון זמני בלבד, שכן אובדן הנתונים בו משמעו אובדן משימות בתור.
תמונת ה־Postgres בקובץ ה־compose הרשמי היא pgvector/pgvector:pg16 ולא תמונת ה־postgres הסטנדרטית, כיוון שהסכימה של Chatwoot מפעילה את הרחבת vector עבור תכונות ה־AI שלה. אם תחליפו ל־Postgres סטנדרטי, הרצת מסד הנתונים הראשונה תיכשל עם ERROR: extension "vector" is not available, כיוון שקובץ הבקרה של ההרחבה אינו קיים בתמונה ההיא. השתמשו בתמונה שהמפתחים מספקים.
מדריך זה מניח ש־Docker ו־reverse proxy כבר פועלים על השרת. אם לא, התחילו ב-Docker Compose על גבי VPS וחזרו לכאן.
כמה משאבי VPS נדרשים עבור אירוח עצמי של Chatwoot?
נכון לאוקטובר 2026, דרישות המערכת הרשמיות מציינות מינימום של 4 GB RAM ו-4 ליבות CPU, עבור היקף של עד 10,000 שיחות ביום. עבור היקף של עד 20,000 שיחות ביום, הדרישה עולה ל-8 GB RAM ו-8 ליבות. כמו כן, נדרש לפחות 1 GB של swap, והסיבה לכך ברורה: מניעת קריסת המכונה מחוסר זיכרון במהלך שדרוג. יש להקצות בין 5 GB ל-10 GB שטח דיסק עבור Postgres, עוד לפני חישוב נפח העלאות הקבצים.
כעת, האמת ללא כחל וסרק: שרת VPS עם 2 GB RAM יצליח להעלות את Chatwoot, והמערכת תיראה תקינה עם שני נציגים ותיבת נכנסים שקטה. עם זאת, המערכת תקרוס בשני מקרים. הראשון הוא Sidekiq, שצורך לפי המפתחים מעל 1 GB בשרת עמוס; פרץ של הודעות דוא"ל או הרצת דוח ידחפו את השרת מעבר למגבלת הזיכרון שלו, עוד לפני ש-Rails, Postgres ו-Redis לקחו את חלקם. השני הוא תהליך השדרוג, שכן db:chatwoot_prepare מפעיל תהליך Rails חדש לצורך החלת מיגרציות, וטעינת Rails על גבי אימג' זה צורכת מאות מגה-בייטים עוד לפני ביצוע פעולה מועילה כלשהי.
המערכת לא תציג אזהרה מנומסת מראש. מנגנון ה-out of memory killer של ה-kernel שולח SIGKILL לתהליך שהוא בוחר, בדרך כלל הגדול ביותר, Docker מזהה שהקונטיינר קרס, ו-restart: always מפעיל אותו מחדש. docker compose ps --all יציג אז קונטיינר שנמצא בלופ של אתחולים או תקוע ב-Exited (137), כאשר קוד 137 מציין סיום עקב signal 9. ללא --all, קונטיינר שעצר לא יופיע ברשימה כלל. קוד יציאה 137 לבדו אינו הוכחה לכך שהסיבה היא זיכרון, שכן גם docker kill שולח את אותו סיגנל, לכן יש לאמת זאת באמצעות sudo dmesg -T | grep -i "killed process", שמציג את שם התהליך שה-kernel בחר להפסיק.
אם 4 GB חורגים מהתקציב, ניתן להריץ שרת עם 2 GB ו-2 GB של swap, תוך קבלת העובדה שזמני התגובה יואטו תחת עומס. ה-swap משמש כחוצץ נגד מחסור בזיכרון, אך אינו ערובה לכך, ופרץ עומס גדול מספיק עדיין עלול להוביל להריגת קונטיינר. בכל מקרה, כדאי להגדיר מגבלת זיכרון קשיחה לכל שירות, כדי שה-worker לא יפיל איתו את מסד הנתונים. ראו מגבלות זיכרון ב-Docker Compose.
העלאות קבצים הן הרכיב שגדל ללא מגבלה מוגדרת מראש. כל צילום מסך שלקוח מצרף נשמר ב-storage volume ונשאר שם, לכן יש לנטר את docker system df -v במקום להניח שמסד הנתונים הוא הגורם למילוי הדיסק.
הורדת קובץ ה-compose וקיבוע גרסה (tag)
mkdir -p ~/chatwoot && cd ~/chatwoot
wget -O .env https://raw.githubusercontent.com/chatwoot/chatwoot/develop/.env.example
wget -O docker-compose.yaml https://raw.githubusercontent.com/chatwoot/chatwoot/develop/docker-compose.production.yaml
chmod 600 .envהקובץ שהורדת כרגע מציין image: chatwoot/chatwoot:latest. שנה זאת לפני שתבצע כל פעולה אחרת.
services:
base: &base
image: chatwoot/chatwoot:v4.19.1
env_file: .env
volumes:
- storage_data:/app/storageהמשמעות של latest היא שה-docker compose pull הבא יספק לך את הגרסה שפורסמה באותו בוקר, מה שעלול להיות גרסה ראשית הכוללת שינויי מבנה בבסיס הנתונים (migrations) שלא קראת עליהם. בפועל, לא ניתן לבטל שינויי מבנה ב-Chatwoot, לכן קפיצה לא מכוונת בגרסה מחייבת שחזור מגיבוי ולא ניתן פשוט לבצע "ביטול". קבע את ה-tag ושנה אותו באופן יזום. נכון ל-25 באוקטובר 2026, הגרסה העדכנית היא v4.19.1, והערות השחרור שלה ממליצות עליה עבור תיקוני האבטחה ושיפורי ההקשחה האחרונים; בדוק את דף השחרורים כדי לדעת איזה tag עליך לקבע היום. אם אתה משדרג מגרסה v4.18.0 או מוקדמת יותר, קרא תחילה את הערות השחרור של v4.19.0: תמיכה ב-Captain V1 הופסקה, והתקנות עצמאיות שהשתמשו בהוראות V1 חייבות לבצע הגירה ל-V2 לפני השדרוג. כל שירות שמנהל בסיס נתונים דורש זהירות דומה, וזו הסיבה ש-אירוח עצמי של openGym workout tracker מתחיל בקיבוע git tag, למרות שמדובר ביישום קטן בהרבה מזה.
השירות base הוא עוגן YAML שגם rails וגם sidekiq משלבים (merge), לכן שינוי ה-tag במקום אחד מעדכן אותו עבור שניהם. בזמן שאתה עורך את הקובץ, מחק את השורה version: '3' בראש הקובץ. גרסאות Compose מודרניות מתעלמות ממנה ומדפיסות the attribute 'version' is obsolete, it will be ignored בכל הרצת פקודה.
מילוי קובץ ה-env.
תחילה צרו את ה-secret. הספק ממליץ על ערך אלפא-נומרי, כיוון שתווים מיוחדים עלולים להשתבש בעת מעבר הערך דרך shell או מנתח YAML.
head /dev/urandom | tr -dc A-Za-z0-9 | head -c 63 ; echo ''לאחר מכן הגדירו את המפתחות הבאים ב-.env.
SECRET_KEY_BASE=<the 63 characters you just generated>
FRONTEND_URL=https://support.example.com
FORCE_SSL=true
DEFAULT_LOCALE=en
ENABLE_ACCOUNT_SIGNUP=true
POSTGRES_HOST=postgres
POSTGRES_USERNAME=postgres
POSTGRES_PASSWORD=<long random string>
POSTGRES_DATABASE=chatwoot
REDIS_URL=redis://redis:6379
REDIS_PASSWORD=<a different long random string>
RAILS_ENV=production
INSTALLATION_ENV=docker
ACTIVE_STORAGE_SERVICE=localPOSTGRES_HOST=postgres ו-redis://redis:6379 הם שמות שירותי ה-Compose, אשר נפתרים ברשת ברירת המחדל של הפרויקט. FRONTEND_URL אינו קישוט. Chatwoot בונה את ה-URL של סקריפט ה-widget ואת כל הקישורים בתוך הודעות דוא"ל יוצאות ממנו, לכן ערך שגוי יגרום לקישורי איפוס סיסמה להפנות למארח שאינו מגיב.
כעת, המלכוד בקובץ של הספק. שירות ה-postgres אינו קורא את .env. הוא נושא בלוק environment משלו עם POSTGRES_PASSWORD= ריק, כך שהגדרת הסיסמה ב-.env בלבד תשאיר את מסד הנתונים ללא סיסמה ואת היישום עם סיסמה. הפנו את השירות לאותו משתנה:
postgres:
image: pgvector/pgvector:pg16
restart: always
volumes:
- postgres_data:/var/lib/postgresql/data
environment:
- POSTGRES_DB=chatwoot
- POSTGRES_USER=postgres
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}Compose קורא את .env מספריית הפרויקט עבור החלפת ${...}, כך ששני הצדדים מקבלים כעת את אותה מחרוזת. טעות כאן תגרום ל-Rails להיעצר עם PG::ConnectionBad: FATAL: password authentication failed for user "postgres".
התנהגות אחת מפתיעה כמעט את כולם: אימג' ה-Postgres מיישם את POSTGRES_PASSWORD רק כאשר הוא מאתחל ספריית נתונים ריקה. לשינוי הערך לאחר מכן אין השפעה, כיוון ש-initdb לעולם אינו רץ פעם שנייה. אם כבר הפעלתם את ה-stack פעם אחת, שנו זאת בתוך מסד הנתונים עצמו.
docker compose exec postgres psql -U postgres -c "ALTER USER postgres WITH PASSWORD 'the-new-password';"ENABLE_ACCOUNT_SIGNUP=true הוא זמני. הוא פותח את טופס ההרשמה הציבורי כדי שתוכלו ליצור את החשבון הראשון. הגדירו אותו ל-false והריצו את docker compose up -d שוב ברגע שהחשבון שלכם קיים, אחרת כל מי שימצא את ה-URL יוכל להירשם למערכת התמיכה שלכם. מאותו רגע, סוכנים יגיעו באמצעות הזמנה והסיסמאות שלהם יחיו רק באפליקציה זו, מה שמתאים עד שתריצו חצי תריסר שירותים ותתעייפו מרשימת חשבונות נפרדת בכל אחד מהם; בנקודה זו ספק זהות בניהול עצמי כמו Authentik הוא הרכיב שמחליף אותם.
.env מכיל כעת כל secret שיש ל-stack הזה, בטקסט גלוי, לכן שמרו אותו במצב 600 והרחיקו אותו מ-git. כיצד Compose קורא קובצי env, והיכן דולפים סודות מכסה את הקצוות החדים, כולל ההבדל בין env_file ל-environment.
הגדרת Chatwoot מאחורי Traefik קיים
אל תבנו reverse proxy נוסף עבור יישום בודד. אם Traefik כבר מבצע TLS termination עבור מכולות אחרות בשרת זה, צרפו את Chatwoot אליו באמצעות בלוק labels. אם טרם הגדרתם זאת, בצעו זאת פעם אחת לפי המדריך Traefik לפני כמה יישומי Docker Compose, ולאחר מכן חזרו לכאן.
שמרו על קובץ ה-docker-compose.yaml המקורי של המפתח קרוב ככל האפשר לגרסת ה-stock כדי שתוכלו להשוות אותו (diff) מול גרסה חדשה בעתיד, והכניסו את השינויים שלכם לקובץ override. Compose ממזג את docker-compose.override.yaml באופן אוטומטי, והמדריך פיצול Compose למספר קבצים מסביר את כללי המיזוג.
services:
rails:
networks:
- default
- proxy
labels:
- "traefik.enable=true"
- "traefik.http.routers.chatwoot.rule=Host(`support.example.com`)"
- "traefik.http.routers.chatwoot.entrypoints=websecure"
- "traefik.http.routers.chatwoot.tls.certresolver=letsencrypt"
- "traefik.http.services.chatwoot.loadbalancer.server.port=3000"
networks:
proxy:
external: trueהשתמשו בשמות ה-entrypoint וה-certresolver שלכם. המכולה חייבת להיות באותה רשת Docker שבה נמצא Traefik, וזהו התפקיד של הערך proxy; עליה להישאר גם ב-default, אחרת היא תאבד את הגישה ל-Postgres ול-Redis. זו השורה השנייה שאנשים נוטים לשכוח.
השאירו את בלוק ה-ports: ללא שינוי. המפתח מגדיר אותו ל-127.0.0.1:3000, שהוא loopback בלבד, לכן הוא אינו נגיש מהאינטרנט ונותר שימושי לבדיקות מתוך השרת באמצעות curl -I http://127.0.0.1:3000.
לוח הבקרה של הסוכן מחזיק חיבור WebSocket פתוח ל-/cable לצורך העברת הודעות בזמן אמת. Traefik מעביר את ה-HTTP upgrade ללא צורך בתצורה נוספת, כך שאין מה להוסיף. אם בעתיד תציבו CDN או proxy נוסף לפני Traefik, אפשרו שם WebSocket, שכן התסמין לכך הוא לוח בקרה שנטען כרגיל, בעוד הודעות חדשות מופיעות רק לאחר רענון ידני.
אתחול מסד הנתונים והפעלת ה-stack
הפעילו תחילה את שירותי הנתונים ואפשרו ל-Postgres לסיים את הריצה הראשונה שלו.
docker compose up -d postgres redis
docker compose logs postgres | tail -n 5המתינו ל-database system is ready to accept connections. לאחר מכן צרו את ה-schema.
docker compose run --rm rails bundle exec rails db:chatwoot_prepareפעולה זו יוצרת את מסד הנתונים אם הוא חסר, ולאחר מכן טוענת את ה-schema ואת נתוני ה-seed המוגדרים כברירת מחדל. הפקודה מדפיסה שורות migration ומסתיימת בצורה תקינה. אם התהליך נתקע בהדפסת postgres:5432 - no response, ה-entrypoint ממתין למסד נתונים שעדיין אינו מקבל חיבורים; בהרצה ראשונה, המשמעות היא בדרך כלל ש-initdb עדיין בתהליך עבודה. המתינו, קראו את הלוגים של Postgres, ולאחר מכן הריצו שוב. אם התהליך נעצר בתוסף vector, סימן שהחלפתם את ה-image של pgvector ב-Postgres סטנדרטי.
docker compose up -d
docker compose ps
docker compose logs --tail 30 railsכל ארבעת ה-containers צריכים להציג Up, והלוג של rails צריך להסתיים בשורת Puma המציינת האזנה ב-http://0.0.0.0:3000. לאחר מכן בדקו את הנתיב הציבורי:
curl -sI https://support.example.com | head -n 1HTTP/2 200 מציין שכל השרשרת עובדת. שגיאת 404 מ-Traefik משמעותה שחוק הניתוב (router rule) לא תאם, בדרך כלל עקב שגיאת הקלדה בשם המארח. שגיאת 502 משמעותה ש-Traefik זיהה את ה-router אך לא הצליח להגיע ל-container; זה קורה כמעט תמיד בגלל רשת proxy חסרה או loadbalancer.server.port שאינו 3000.
פתחו את ה-URL, צרו את החשבון שלכם ב-/app/auth/signup, לאחר מכן הגדירו את ENABLE_ACCOUNT_SIGNUP=false והריצו את docker compose up -d כדי לסגור את הטופס.
מדוע איפוס סיסמאות ותכתובות דוא"ל נכשלים ללא SMTP
Chatwoot ללא הגדרות SMTP (פרוטוקול העברת דואר פשוט) הוא מוקד תמיכה שאינו יכול לשלוח דואר, וזה משבש הרבה יותר מאשר רק התראות. איפוס סיסמאות מפסיק לעבוד, כך שמנהל מערכת שננעל מחוץ למערכת נשאר נעול. הזמנות לסוכנים מפסיקות לעבוד, כיוון שהזמנה היא הודעת דוא"ל. מענה ללקוח בתוך תכתובת דוא"ל מפסיק לעבוד, כך שהתקשורת הופכת לחד-צדדית. זהו השלב שאנשים מדלגים עליו ומגלים את חשיבותו ברגע הכי פחות מתאים.
המנגנון פשוט. ללא SMTP_ADDRESS מוגדר, Chatwoot מעביר את ActionMailer למשלוח דרך sendmail. התיעוד הרשמי מתייחס לכך כאל הגדרת Postfix, ברירת המחדל מאז גרסה v2.12.0, וההוראות עבורו מתקינות Postfix על השרת עם sudo apt install -y postfix. הגדרת Docker זו אינה מבצעת זאת, לכן אין שרת דואר מוגדר למסירת הדואר. הדואר נשלח ממשימת רקע, כך שכל שגיאה שנוצרת בתהליך המשלוח מופיעה בלוג של Sidekiq ולא בלוג של Rails. בינתיים, המשתמש שלוחץ על "שכחתי סיסמה" רואה אישור עליז אך לא מקבל דבר.
MAILER_SENDER_EMAIL=Support <support@example.com>
SMTP_DOMAIN=example.com
SMTP_ADDRESS=smtp.example.com
SMTP_PORT=587
SMTP_USERNAME=support@example.com
SMTP_PASSWORD=<the relay password>
SMTP_AUTHENTICATION=plain
SMTP_ENABLE_STARTTLS_AUTO=trueהשתמשו בפורט 587 עם STARTTLS, שפותח את החיבור בטקסט גלוי ומשדרג אותו להצפנה לפני האימות. ספקי VPS רבים חוסמים את פורט 25 יוצא כברירת מחדל כדי להגביל דואר זבל. נכון ל-8 בנובמבר 2026, Hetzner חוסמת את פורטים 25 ו-465 כברירת מחדל בשרתי ענן, כאשר החסימה נאכפת ברמת החשבון, ו-Vultr חוסמת את פורט 25 בכל ה-Compute Instances החדשים. שניהם בוחנים בקשות להסרת חסימה באופן פרטני; Hetzner דורשת ותק של חודש כלקוח ותשלום חשבונית ראשונה לפני שניתן להגיש בקשת הסרת הגבלה. אף אחד מהם לא חוסם את 587, לכן ממסר (relay) בפורט 587 עובד מהאתחול הראשון ללא צורך בכרטיס תמיכה או המתנה. SMTP_DOMAIN הוא שם המתחם שהשרת שלכם מציג במהלך שיחת ה-SMTP, וחלק מהממסרים דוחים חוסר התאמה.
החילו את ההגדרות ועקבו אחר ה-worker:
docker compose up -d rails sidekiq
docker compose logs -f sidekiqבצעו איפוס סיסמה מדף ההתחברות. משלוח תקין יציג את משימת ה-mailer מסתיימת כראוי בלוג של Sidekiq. כשל יציג את מחלקת החריגה (exception class), ולאחר מכן Sidekiq ינסה שוב עם השהיה גדלה (backoff), וזו הסיבה שממסר תקול מייצר את אותה שגיאה בכל כמה דקות במשך שעות.
שתי דחיות הן נפוצות, ואף אחת מהן אינה באג ב-Chatwoot. 535 Authentication failed משמעותו שהאימות נכשל, לכן בדקו את פרטי ההתחברות, האם אימות SMTP מופעל והאם מדיניות גישה חוסמת אותו; פרטי התחברות נכונים בלבד אינם פוסלים שגיאה זו. ספקים מסוימים דורשים סיסמת אפליקציה במקום סיסמת החשבון. 550 Sender address rejected משמעותו שהשרת דחה את כתובת השולח; קראו את התגובה המלאה לפני שינוי MAILER_SENDER_EMAIL. הרשאות שולח או אימות הם סיבה אחת, אך 550 5.7.27 Sender address rejected: Domain does not accept mail מצביע על מתחם שולח עם רשומת MX ריקה (null).
קבלת דוא"ל לתוך תכתובת היא משימה נפרדת. עבור העברה דרך ה-ingress של Chatwoot, נדרשים MAILER_INBOUND_EMAIL_DOMAIN ו-RAILS_INBOUND_EMAIL_SERVICE, בנוסף לשרת דואר שמעביר הודעות נכנסות ל-Chatwoot. ניתן גם לחבר תיבת דואר דרך IMAP, כולל Google או Microsoft OAuth, ללא הגדרת נתיב העברה זה. שכירת ממסר היא הדרך המהירה ביותר. אם אתם מעדיפים להחזיק בכל נתיב הדואר בעצמכם, הרצת שרת דואר עצמאי עם Mailcow מכסה את מה שמחויבות כזו באמת דורשת.
מה לגבות, ואיך לוודא שהשחזור עובד
גיבוי של Chatwoot מורכב מארבעה חלקים; דילוג על אחד מהם יהפוך את השחזור לבנייה מחדש.
- מסד הנתונים Postgres, המכיל שיחות, אנשי קשר, חשבונות סוכנים וכל הגדרה.
- הווליום
storage_data, מכיוון ש־ACTIVE_STORAGE_SERVICE=localכותב קבצים שהועלו לדיסק ושומר ב־Postgres רק הפניה אליהם. - הקובץ
.env, מכיוון שהוא מכיל אתSECRET_KEY_BASEואת מפתחות ה־ACTIVE_RECORD_ENCRYPTION_*. - קובצי ה-compose, מכיוון שהם מתעדים את תגית ה-image המדויקת שתואמת לסכימת מסד הנתונים שלכם.
אם תשחזרו רק את מסד הנתונים, כל שיחה תחזור עם קבצים מצורפים שבורים, כיוון שהשורות מצביעות על קבצים שכבר אינם קיימים על הדיסק.
cd ~/chatwoot
docker compose exec -T postgres pg_dump -U postgres -Fc chatwoot > db-$(date +%F).dumpהשימוש ב־-T הוא קריטי. בלעדיו, Compose מקצה מסוף פסאודו (pseudo terminal) שמשכתב בייטים של ירידת שורה בזרם הנתונים, מה שיוצר קובץ dump ש־pg_restore דוחה. -Fc הוא הפורמט הייעודי, המאפשר דחיסה ושימוש ב־pg_restore לשחזור סלקטיבי.
docker run --rm -v chatwoot_storage_data:/data:ro -v "$PWD":/backup alpine \
tar czf /backup/storage-$(date +%F).tgz -C /data .שם הווליום הוא שם תיקיית הפרויקט שלכם בתוספת _storage_data. אשרו את השם באמצעות docker volume ls | grep storage_data לפני שאתם סומכים על הפקודה, כיוון ש-Docker יוצר ווליום ריק במקום להיכשל אם תציינו שם שלא קיים. אתם עלולים לקבל ארכיון תקין אך ריק ללא כל הודעת שגיאה. בדקו את הגודל לאחר מכן באמצעות ls -lh storage-*.tgz.
שני הקבצים נמצאים כעת על אותו דיסק שהם אמורים להגן עליו, מה שלא מספק הגנה כלל. העבירו אותם מחוץ לשרת והצפינו אותם, כיוון ש-dump של מסד נתונים מכיל את כל הודעות הלקוחות בטקסט גלוי. גיבויים מוצפנים מחוץ לאתר עם restic מכסה את נושאי התזמון ושמירת הגיבויים.
תרגול שחזור: בצעו אותו לפני שתזדקקו לו
בצעו שחזור לשרת VPS משני, לא לשרת הפעיל. העתיקו את .env, את קובצי ה-compose ואת שני הארכיונים, ולאחר מכן הריצו:
docker compose up -d postgres
docker compose exec -T postgres pg_restore -U postgres -d chatwoot --clean --if-exists < db-2026-08-10.dump
docker run --rm -v chatwoot_storage_data:/data -v "$PWD":/backup alpine \
sh -c 'rm -rf /data/* && tar xzf /backup/storage-2026-08-10.tgz -C /data'
docker compose up -dהפקודה --clean --if-exists מוחקת את האובייקטים הקיימים לפני הטעינה, לכן הפנו אותה רק למסד נתונים שאתם מוכנים לאבד. לאחר מכן, התחברו ופתחו שיחה שיש בה קובץ מצורף. אם רשימת ההודעות נטענת והקובץ יורד, הגיבוי תקין.
שחזור עם SECRET_KEY_BASE שונה מבטל את כל עוגיות ה-session, ולכן כל המשתמשים ינותקו. שחזור עם מפתחות ACTIVE_RECORD_ENCRYPTION_* שונים הוא בעייתי אף יותר: Chatwoot לא יוכל לפענח את העמודות המכילות את פרטי הגישה לערוצים ויציג את השגיאה ActiveRecord::Encryption::Errors::Decryption. זו הסיבה ש-.env נמצא ברשימת הגיבויים.
כיצד לשדרג את Chatwoot לגרסה (tag) חדשה
סדר הפעולות חשוב יותר מהפקודות עצמן.
- קראו את הערות השחרור (release notes) שבין הגרסה הנוכחית שלכם לגרסת היעד, וחפשו שלבים ידניים נדרשים.
- בצעו גיבוי מלא של מסד הנתונים וארכיון של תיקיית האחסון, וודאו שגודל הקבצים נראה תקין.
- עדכנו את ה-tag של האימג' בשירות
baseבתוךdocker-compose.yaml. - משכו את האימג' החדש, עצרו את ה-stack, הריצו את המיגרציות (migrations), ולאחר מכן הפעילו מחדש.
docker compose pull
docker compose down
docker compose run --rm rails bundle exec rails db:chatwoot_prepare
docker compose up -d
docker compose imagesמשכו את האימג' לפני ביצוע המיגרציה, כיוון שהמיגרציה חייבת לרוץ מתוך האימג' החדש: האימג' הישן אינו מכיל את קובצי המיגרציה החדשים. עצרו את ה-stack לפני המיגרציה, כיוון שהקוד הישן והסכימה החדשה אינם תואמים; תהליך Rails ישן שרץ עלול להפיק שגיאות או לכתוב רשומות שהסכימה החדשה לא תקבל. עצירה גם מפנה את הזיכרון הדרוש למיגרציה, וזו הסיבה המלאה לכך שהמפתחים דורשים הגדרת swap.
הפקודה docker compose images מציגה את ה-tag שכל קונטיינר מריץ בפועל, מה שמאפשר לזהות מקרים שבהם עדכנתם את ה-tag אך שכחתם לבצע pull.
טווח השדרוג תלוי במידת העתיקות של ההתקנה. עבור התקנה המפגרת בגרסה או שתיים, עברו על הערות השחרור שבין הגרסה שלכם ליעד, הגדירו את ה-tag של היעד, ובצעו את השלבים לעיל פעם אחת. רק אם ההתקנה שלכם ישנה מאוד, מדריך ה-Docker של המפתחים מורה לשדרג באופן הדרגתי דרך גרסאות ביניים במקום לקפוץ ישירות לאימג' האחרון. במקרה כזה, חזרו על שלבי שינוי ה-tag, ה-pull וההכנה עבור כל גרסת ביניים, כיוון שהמפתחים דורשים הרצה של db:chatwoot_prepare לאחר כל שדרוג.
אם Rails עולה לפני הרצת המיגרציה, הוא יסרב לשרת בקשות וירשום בלוגים ActiveRecord::PendingMigrationError: Migrations are pending. כאשר restart: always מוגדר, הקונטיינר יבצע מחזוריות (restart loop), כך ש-docker compose ps יציג זמן פעילות (uptime) שמתאפס בכל כמה שניות. הרצת שלב ההכנה תפתור זאת.
חזרה לגרסה קודמת (rollback) משמעותה החזרת ה-tag הישן ושחזור הגיבוי. אין נתיב מיגרציה הפוך שניתן להסתמך עליו, וזו הסיבה לקיום שלב 2.
מצבי כשל והודעות שיופיעו
502 Bad Gateway מ-Traefik. הנתב זיהה את הבקשה אך ה-backend לא השיב. בדקו ש-docker compose ps מציג את rails כ-Up, לאחר מכן הריצו את docker network inspect proxy וודאו שמכולת ה-rails מופיעה ברשימת המכולות. מכולה שאינה פעילה אינה גלויה ל-Traefik, לכן הבקשה מותאמת לנתב אך אין לה לאן להמשיך.
לוח הבקרה נטען אך הודעות חדשות דורשות רענון. ה-websocket ל-/cable לא עובר, או ש-FRONTEND_URL אינו תואם לכתובת בשורת הכתובות בדפדפן. חוסר התאמה גורם לדף לנסות לפתוח websocket למקור (origin) שונה, מה שהדפדפן חוסם.
FATAL: password authentication failed for user "postgres". הסיסמה ב-.env שונה מזו שמוטמעת בנפח הנתונים של Postgres. תקנו זאת באמצעות ALTER USER בתוך המכולה הרצה, כיוון שעריכה חוזרת של .env לא תשנה מסד נתונים שכבר אותחל.
NOAUTH Authentication required. Redis רץ עם --requirepass אך היישום התחבר ללא סיסמה, לכן REDIS_PASSWORD חסר ב-.env או שלא נטען. בדקו את הסיסמה ש-Redis מצפה לה ישירות עם docker compose exec redis sh -c 'redis-cli -a "$REDIS_PASSWORD" ping', שאמור להשיב PONG. למירכאות הבודדות יש חשיבות: הן גורמות למשתנה להתרחב בתוך המכולה, שקוראת את .env, במקום ב-shell שלכם, שבו הוא בדרך כלל ריק.
מכולות יוצאות עם קוד 137. זהו אות SIGKILL. בשרת קטן, השולח הרגיל הוא מנגנון ה-out of memory killer של ה-kernel, אך docker kill שולח את אותו האות, לכן בדקו את sudo dmesg -T | grep -i "killed process" לפני שתאשימו את הזיכרון. אם מדובר בזיכרון, הוסיפו swap, הגדירו מגבלות זיכרון לכל שירות, או עברו לתוכנית גדולה יותר.
FAQ
כמה זיכרון RAM דרוש לשרת VPS המארח Chatwoot באופן עצמאי?
נכון לאוקטובר 2026, הדרישה המינימלית של המפתחים היא 4 GB של RAM ו-4 ליבות CPU, עבור עד 10,000 שיחות ביום, ו-8 GB עם 8 ליבות עבור עד 20,000 שיחות. יש להוסיף לפחות 1 GB של swap, כיוון שביצוע שדרוג מפעיל תהליך Rails נוסף לצורך החלת מיגרציות, וזהו השלב שבו שרתים קטנים חורגים מהזיכרון הזמין. שרת VPS עם 2 GB יאתחל ויעבוד עבור מספר קטן של נציגים, אך Sidekiq לבדו עלול לעבור את ה-1 GB תחת עומס, לכן יש לצפות לכך שמכולות יקרסו עם exit code 137 בתקופות עמוסות או במהלך שדרוגים.
מדוע הודעות איפוס סיסמה של Chatwoot לעולם לא מגיעות?
מכיוון ש-SMTP_ADDRESS לא הוגדר, Chatwoot חוזר להשתמש במשלוח דרך sendmail, אשר מיועד לשרת Postfix המותקן על המארח, בעוד שהגדרת ה-Docker הזו אינה כוללת שרת כזה. המשימה רצה בתוך Sidekiq, לכן כל שגיאת משלוח נרשמת בלוג של Sidekiq, בעוד הדפדפן עדיין מציג הודעת הצלחה. הגדירו את SMTP_ADDRESS, SMTP_PORT, SMTP_USERNAME, SMTP_PASSWORD ו-MAILER_SENDER_EMAIL בתוך .env, הפעילו מחדש את שירותי ה-rails וה-sidekiq, ולאחר מכן עקבו אחר docker compose logs -f sidekiq בזמן שאתם מפעילים איפוס.
מה עלי לגבות כדי לשחזר את Chatwoot?
את מסד הנתונים Postgres, את ה-volume של Docker מסוג storage_data, את הקובץ .env ואת קובצי ה-compose. מסד הנתונים לבדו אינו מספיק, כיוון שקבצים שהועלו נמצאים בתוך ה-volume בעוד ש-Postgres מחזיק רק הפניות אליהם; לכן שחזור של מסד הנתונים בלבד יניב שיחות עם קבצים מצורפים שבורים. .env הוא קריטי, כיוון ש-SECRET_KEY_BASE שונה ינתק את כל המשתמשים, ומפתחות ACTIVE_RECORD_ENCRYPTION_* שונים יהפכו את העמודות המוצפנות לבלתי קריאות.
כיצד אוכל לשדרג את Chatwoot מבלי לפגוע במסד הנתונים?
בצעו גיבוי, קראו את הערות השחרור (release notes) שבין התג (tag) הנוכחי שלכם לבין תג היעד, שנו את תג התמונה בקובץ ה-compose שלכם, ולאחר מכן הריצו את docker compose pull, docker compose down, docker compose run --rm rails bundle exec rails db:chatwoot_prepare ו-docker compose up -d. בצעו pull תחילה כיוון שהמיגרציות חייבות לרוץ מהתמונה החדשה, ועצרו את ה-stack תחילה כיוון שקוד ישן מול סכימה חדשה מעורר שגיאות. רק התקנות ישנות מאוד דורשות מעבר דרך תגי תמונה ενδιάμεסים במקום קפיצה ישירה לגרסה האחרונה, תוך הרצת שלב ה-prepare לאחר כל אחד מהם.
האם ניתן להשתמש בתמונת postgres סטנדרטית במקום ב-pgvector?
לא. הסכימה של Chatwoot מפעילה את התוסף vector, לכן התמונה הרגילה postgres תיכשל במהלך db:chatwoot_prepare עם השגיאה ERROR: extension "vector" is not available, כיוון שקובץ הבקרה של התוסף אינו קיים בתמונה זו. שמרו על pgvector/pgvector:pg16 מקובץ ה-compose המקורי, או השתמשו בתמונה אחרת שמספקת את pgvector עבור גרסת ה-Postgres הראשית שלכם.