📘 תיעוד 3

התקנה בשורה אחת

התקן את n8n משורת הפקודה באמצעות התקנה בשורה אחת.

#למי זה מיועד

מדריך זה מגדיר מופע n8n חדש לגמרי באמצעות פקודה אחת שמחליפה את הגישה הישנה של npm install n8n / npx n8n, שאינה פועלת עוד החל מ-n8n 3.0 (מושק באוקטובר 2026). זוהי הדרך המהירה ביותר להפעיל את n8n, בין אם השתמשת ב-Docker בעבר ובין אם לא.

זה מיועד להתקנות חדשות, לא לשינוי של הגדרה קיימת:

• כבר מארח בעצמך עם קובץ Docker Compose משלך? אינך צריך לעבור לסקריפט הזה, אך אתה מוזמן לקבל השראה מתהליך ההגדרה של Docker Compose.
• מתקין כעת את n8n באמצעות npm? החל מ-n8n 3.0, n8n מופץ רק דרך Docker. התקנת ה-npm הקיימת שלך תמשיך לעבוד לעת עתה, אך התקנות חדשות (ושדרוגים עתידיים) צריכות להשתמש בשיטה זו במקום. מדריך הגירה צעד אחר צעד יגיע בקרוב.

#מה שאתה צריך לפני שאתה מתחיל

שיטה זו משתמשת ב-Docker, כלי שמריץ את n8n בחבילה עצמאית כדי שלא תצטרך להתקין או להגדיר שום דבר אחר בעצמך. אם אין לך אותו עדיין:

• התקן את Docker. זה כולל את Docker Compose, שפקודת ההגדרה צריכה גם כן.

אינך צריך להכיר את Docker כדי להשתמש במדריך זה, רק שיהיה מותקן וירוץ ברקע.

פקודת ההתקנה בשורה אחת דורשת באופן ספציפי את התוסף docker compose v2 (ולא את הקובץ הבינארי העצמאי הישן docker-compose), ובודקת שדמון ה-Docker פועל. אם אתה משתמש ב-Podman, ב-Colima או במנועים אחרים התואמים ל-Docker, התקן את ה-CLI של docker עם תוסף ה-compose וכוון את DOCKER_HOST אל ה-socket שלהם.

צפה במדריך וידאו המכסה את ההגדרה הזו, מהתקנת Docker ועד הפעלת n8n Assistant:

https://www.youtube.com/embed/t5RBVTby9EU

#הפעל את הפקודה

פתח מסוף והפעל:

curl -fsSL https://get.n8n.io | sh

זה עושה הכל עבורך:

1. בודק ש-Docker מותקן ורץ, ואומר לך כיצד לתקן זאת אם לא.
2. יוצר תיקייה חדשה בשם n8n בספרייה הנוכחית שלך כדי להחזיק את הכל.
3. כותב את קובצי התצורה ש-n8n צריך כדי לרוץ.
4. מוריד את n8n ומפעיל אותו.

בטוח להריץ את זה יותר מפעם אחת. אם n8n כבר מוגדר בתיקייה הזו, הפקודה פשוט אומרת לך שהוא כבר שם במקום לשנות משהו.

הרצה מוצלחת נראית כך:

$ curl -fsSL https://get.n8n.io | sh

✓ Docker found (24.0.6)
✓ Docker Compose found (v2.24.0)
✓ Created ./n8n/compose.yml
✓ Created ./n8n/searxng-settings.yml
✓ Created ./n8n/.env (unique secrets generated)
Pulling images and starting (this can take a few minutes on first run)...
✓ Started n8n 2.32.0 and sandbox services

n8n is running at: http://localhost:5678
Data stored in:    ./n8n (Docker volume: n8n-data)
Config files:      ./n8n/compose.yml, ./n8n/.env

To stop:      docker compose -f ./n8n/compose.yml down
To upgrade:   curl -fsSL https://get.n8n.io | sh -s -- --upgrade
To uninstall: docker compose -f ./n8n/compose.yml down -v   
# -v DELETES all n8n data
              rm -rf ./n8n

ל-n8n לוקח רגע לסיים להתחיל בפעם הראשונה. הפקודה ממתינה ומדפיסה את כתובת ה-URL רק כאשר הוא מוכן. אם הדף אינו נטען מיד, המתן מעט ורענן.

#מה כלול כברירת מחדל

הפעלת הפקודה מגדירה את כל מה שלמטה באופן אוטומטי. אין שום דבר נוסף להתקין:

אם אתה מגדיר את n8n עבור צוות או סביבת ייצור (production), שקול מסד נתונים חזק יותר כמו Postgres במקום ברירת המחדל המובנית. ראה התקנה באמצעות Docker Compose עבור הגדרה זו.

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

#אופציונלי: הפעלת n8n Assistant

n8n פועל במלואו ללא n8n Assistant, שהוא תוספת אופציונלית. ברגע ש-n8n פועל, הדרך הקלה ביותר להפעיל אותו היא מתוך ממשק המשתמש בהגדרות ה-AI של המופע. הוסף את מפתח ה-API של המודל שלך שם. מעדיף להגדיר אותו עוד לפני שתתחבר לראשונה? ערוך את .env במקום זאת:

1. פתח את קובץ ה-.env שהפקודה יצרה (ב-./n8n/.env כברירת מחדל).
2. הוסף את מפתח ספק ה-AI שלך לשורת N8N_INSTANCE_AI_MODEL_API_KEY.
3. הפעל מחדש את n8n: docker compose -f ./n8n/compose.yml up -d

שלבי ההגדרה המלאים, כולל הספקים הנתמכים, נמצאים בהגדרת n8n Assistant.

כברירת מחדל, חיפוש הרשת של n8n Assistant פועל באמצעות כלי חיפוש מצורף ללא צורך בהגדרה כלשהי. אם אתה מעדיף להשתמש ב-Brave Search, הוסף את מפתח ה-API של Brave אל INSTANCE_AI_BRAVE_SEARCH_API_KEY באותו קובץ .env. השימוש בו נעשה אוטומטית ברגע שהוא מוגדר.

אינך צריך לפתוח פתחות (ports) נוספות או להגדיר שום דבר עבור שירותים אלה. רק n8n עצמו (פורט 5678) נגיש אי פעם מחוץ למחשב שלך. כל השאר נשאר פרטי כברירת מחדל.

#פקודות יומיומיות

#מה שדרוג משנה

פקודת השדרוג מעבירה הן את n8n והן את שירותי ארגז החול המצורפים לגרסאות חדשות יותר. היא עורכת שתי שורות ב-.env: N8N_VERSION ו-N8N_SANDBOX_VERSION. הנתונים, הסודות ושאר ההגדרות שלך נשארים כפי שהם.

אם התקנת לפני שגרסת ארגז החול עברה אל .env, קובץ ה-compose.yml שלך עדיין מציין תגיות תמונה קבועות של ארגז החול. השדרוג הראשון משכתב את שורות התמונה האלו כדי להשתמש ב-N8N_SANDBOX_VERSION, מחליף את כתובת מריץ ארגז החול (SANDBOX_RUNNER_HTTP_BASE_URL) מ-http:// ל-https://, ומדפיס הערה שמציינת זאת. שום דבר אחר ב-compose.yml אינו משתנה, כך שכל עריכה שביצעת נשארת במקומה.

#דגלים (לשליטה נוספת)

הוספת דגלים אלה לסוף פקודת ההתקנה משנה את מה שהיא עושה:

#מעדיף לא להריץ סקריפט מהאינטרנט?

אתה יכול להוריד ולקרוא אותו תחילה, ואז להריץ אותו בעצמך:

curl -fsSL https://get.n8n.io -o get-n8n.sh
less get-n8n.sh   
# review it
sh get-n8n.sh

#משתמשי Windows

פקודת ההתקנה בשורה אחת זקוקה למסוף שמבין סקריפטים של מעטפת (shell scripts), מה ששורת הפקודה הרגילה של Windows (Command Prompt) או PowerShell אינם מבינים. הפעל אותה במקום זאת מתוך:

• WSL (Windows Subsystem for Linux), כאשר אינטגרציית WSL2 של Docker Desktop מופעלת.
• Git Bash (מותקן לצד Git for Windows) כאשר Docker Desktop פועל יכול גם כן להריץ סקריפטים של מעטפת POSIX, אך n8n לא אימתה זאת מקצה לקצה עבור פקודת ההתקנה בשורה אחת. הישאר עם WSL אלא אם כן וידאת ש-Git Bash עובד עבור ההגדרה שלך.