⬇️ פרק 3

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

לפי One-line setup, זו הדרך המהירה ביותר להפעיל את n8n, בין אם יש לכם ניסיון קודם ב-Docker ובין אם לא.

#למי זה מיועד

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

השיטה מיועדת להתקנות חדשות, ולא לשינוי התקנה קיימת:

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

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

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

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

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

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

#הרצת הפקודה

פותחים מסוף ומריצים:

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 רגע להשלים את העלייה. הפקודה ממתינה ומדפיסה את הכתובת רק כשהוא מוכן. אם הדף אינו נפתח מיד, ממתינים מעט ומרעננים.

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

הרצת הפקודה מגדירה את כל הרכיבים הבאים באופן אוטומטי, ללא צורך בהתקנה נוספת:

המלצות להתקנה בצוות או בסביבת ייצור:

• מסד נתונים: עבור צוות או סביבת ייצור, כדאי לשקול מסד נתונים חזק יותר כמו Postgres במקום ברירת המחדל המובנית. ראו Install using Docker Compose.
• סביבת sandbox: התקנה זו משתמשת ב-sandbox המצורף של n8n שמתאים להתנסות, אך עבור סביבת ייצור n8n ממליצה כיום על Daytona. ראו Set up 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

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

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

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

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

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

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

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

#דגלים (לבקרה נוספת)

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

#בדיקת הסקריפט לפני הרצה

מי שמעדיף לא להריץ סקריפט ישירות מהאינטרנט יכול להוריד אותו, לקרוא אותו, ואז להריץ בעצמו:

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

#משתמשי Windows

פקודת ההתקנה דורשת מסוף שמבין סקריפטים של shell, מה ש-Command Prompt ו-PowerShell הרגילים של Windows אינם מספקים. יש להריץ את הפקודה מאחד מאלה:

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