# התחלה מהירה

> הפעילו את Nodaro במהדורת Community באירוח עצמי בשתי פקודות, בדקו אותו בדף ‎/setup, ואז הוסיפו מפתח ספק או חיבור ל-Nodaro Cloud כדי ליצור.

Source: https://nodaro.ai/he/docs/self-hosting/quickstart

**ההתחלה המהירה של מהדורת Community** מביאה אתכם בשתי פקודות מאפס ל-Nodaro שרץ באירוח עצמי. מערך השירותים של Docker Compose מגיע עם מסד נתונים, שירות התחברות, אחסון ותורים משלו, ולכן אין חשבונות ענן ליצור, אין מפתחות API לחפש ואין מה להגדיר. צריך Docker בגרסה 24 ומעלה עם Docker Compose v2.

## הפעלת Nodaro
### שכפול מאגר הקוד והפעלת המערך
```bash
git clone https://github.com/nodaroai/app.nodaro.ai.git nodaro
cd nodaro
docker compose -f docker-compose.community.yml up
```

האתחול הראשון מוריד את אימג׳ האפליקציה הבנוי מראש, בגודל של כ-2.4 GB, ואת השירותים שמגיעים איתו. זו הורדה, לא קומפילציה, ולכן היא לא מעמיסה על המעבד שלכם. האתחולים הבאים נמשכים שניות.

### פתיחת האפליקציה ויצירת החשבון שלכם
פתחו את `http://localhost:3000` והירשמו עם כל כתובת אימייל וסיסמה. החשבון עובד מיד, כי מערך מקומי לא שולח אימייל אישור.

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

### בדיקת ההתקנה בדף `/setup`
פתחו את `http://localhost:3000/setup`. הדף מציג את הסטטוס בזמן אמת של מסד הנתונים, של Redis, של האחסון, של מפתח ההצפנה ושל מפתחות הספק שלכם, והוא לא דורש התחברות. במערך חדש, כל הכרטיסים ירוקים חוץ מהכרטיס של מפתחות הספק.

### הוספת ספק מודלים
בחרו אחת משלוש הדרכים שלמטה. כשיש ספק, לחצו על **הרצה** ברכיב **תמונת הסצנה** של ההדגמה. הרכיב משתמש ב-[Z-Image](https://nodaro.ai/docs/models/image/z-image), מודל התמונה הזול ביותר, ומחזיר תוצאה בתוך שניות.

## אילו שירותים מופעלים
| שירות | מה הוא עושה | איפה הנתונים שלו נשמרים |
| --- | --- | --- |
| **Postgres** (אימג׳ של Supabase) | מסד הנתונים. המיגרציות מוחלות מעצמן באתחול הראשון. | ה-volume `db-data` |
| **GoTrue** | התחברות עם אימייל וסיסמה. לא צריך שרת אימייל. | — |
| **PostgREST** | ה-API של הנתונים, שהעורך מדבר איתו | — |
| **MinIO** | אחסון המדיה. התמונות, הסרטונים והאודיו שנוצרים נשארים בדיסק שלכם. | ה-volume `minio-data` |
| **Redis** | תורי המשימות | ה-volume `redis-data` |
| **Nodaro** | האפליקציה: העורך, ה-API וה-workers, בפורט `3000` | ה-volume `app-data` |

המערך חושף שני פורטים במחשב שלכם: הפורט `3000` לאפליקציה והפורט `9001` לקונסולה של MinIO, שזמינה רק בממשק ה-loopback.

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

שלוש הדרכים יכולות לפעול זו לצד זו, עם כלל אחד. כשההתקנה מחוברת ל-Nodaro Cloud ויש לה גם `NODARO_API_KEY`, היא משתמשת בחיבור ומתעלמת מהמפתח.

**הדבקת מפתח**

בלי קבצים ובלי הפעלה מחדש.

1. פתחו את הדף `/setup` והשלימו את שלב 1, **יצירת פרטי ההתחברות לשרת**. כרטיסי התקינות לא דורשים התחברות, אבל שמירת מפתח כן.
2. מצאו את אריחי הספקים במקטע **תקינות ההתקנה**. אותם אריחים נמצאים גם באפליקציה, תחת **אינטגרציות › ספקי מודלים**.
3. לחצו על **הדבקת מפתח** באחד האריחים, הדביקו את המפתח ושמרו.

כל אריח מציין במה המפתח שלו משמש ואיפה אפשר להשיג מפתח כזה. המפתח נשמר מוצפן במסד הנתונים שלכם ונכנס לתוקף מיד. אם תחברו את ההתקנה ל-Nodaro Cloud, אף אריח לא נדרש: החיבור מכסה את כולם.

**חיבור ל-Nodaro Cloud**

בלי מפתחות לנהל.

1. בדף `/setup`, בשלב 2, **חיבור ספק מודלים**, לחצו על **חיבור nodaro.ai**.
2. הדפדפן שלכם פותח את מסך ההסכמה של Nodaro Cloud. התחברו, או צרו חשבון חינמי עם 1,500 קרדיטים, ואשרו.
3. אתם חוזרים להתקנה שלכם, וההתקנה כבר מחוברת.

מודלי תמונה, וידאו, דיבור וטקסט רצים אז דרך חשבון ה-Nodaro Cloud שלכם, ומשלמים עליהם בקרדיטים. הפרטים נמצאים בדף [חיבור ל-Nodaro Cloud](https://nodaro.ai/docs/self-hosting/cloud-connect).

**הגדרה בקובץ ‎.env**

למי שעובד בתשתית כקוד (IaC). צרו קובץ בשם `.env` ליד קובץ ה-Compose:

```bash
KIE_API_KEY=...            # broadest model coverage
# or
REPLICATE_API_TOKEN=...
# or
NODARO_API_KEY=...         # a personal API token from app.nodaro.ai, Settings › API Tokens
```

ואז החילו אותו:

```bash
docker compose -f docker-compose.community.yml up -d
```

מפתח בקובץ `.env` גובר על מפתח שהודבק במסך. האריח שלו מציג `set (env)`, ואי אפשר לערוך אותו במקום.

בדף [מפתחות ספק](https://nodaro.ai/docs/self-hosting/provider-keys) מפורטים כל הספקים, ומה כל אחד מהם מאפשר.

אתם משלמים ישירות לספקים שלכם. במהדורת Community אין מערכת קרדיטים, אין עמלות של Nodaro ואין סימן מים.

## למידת העורך בחינם
הלשונית **מדריכים** בדף הבית נפתחת בסדרה של מדריכים שלב אחר שלב, שנוספים באתחול הראשון. העיון בהם לא עולה כלום. התמונות, הסרטונים והאודיו שלהם נטענים מה-CDN של Nodaro, ולכן הם צריכים חיבור לאינטרנט. ראו את הדף [מדריכים ותבניות](https://nodaro.ai/docs/get-started/tutorials-and-templates).

## בדיקת ההתקנה משורת הפקודה
לבדיקה מעמיקה יותר ממה שהדף `/setup` יכול להציג, הריצו את סקריפט בדיקת החוזה מהעותק המשוכפל שלכם. הסקריפט צריך Node.js.

```bash
node tools/community-smoke.mjs http://localhost:3000
```

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

כדי לבדוק גם יצירה אמיתית, הוסיפו `--keyed`:

```bash
node tools/community-smoke.mjs http://localhost:3000 --keyed
```

הדגל `--keyed` דורש `KIE_API_KEY` או `REPLICATE_API_TOKEN` בהתקנה, בקובץ `.env` או כמפתח שהודבק בדף `/setup`. הוא מריץ יצירה אחת במודל הזול ביותר של המפתח הזה: [Z-Image](https://nodaro.ai/docs/models/image/z-image) עם `KIE_API_KEY`, ו-[Flux 2 Klein](https://nodaro.ai/docs/models/image/flux-2-klein-open) עם `REPLICATE_API_TOKEN`. בדרך כלל זה עולה אצל הספק פחות מסנט אחד. אחר כך הסקריפט בודק שהמדיה הגיעה לאחסון של ההתקנה עצמה. חיבור או אסימון של Nodaro Cloud נבדקים בנפרד.

## פקודות יומיומיות
| פעולה | פקודה |
| --- | --- |
| הפעלה ברקע | `docker compose -f docker-compose.community.yml up -d` |
| מעקב אחרי היומנים | `docker compose -f docker-compose.community.yml logs -f` |
| עצירת המערך | `docker compose -f docker-compose.community.yml down` |
| החלת קובץ `.env` ששונה | `docker compose -f docker-compose.community.yml up -d` |

אל תוסיפו `-v` ל-`down` אלא אם זו באמת הכוונה: הפקודה `docker compose down -v` מוחקת את ה-volumes, ואיתם את מסד הנתונים ואת המדיה שלכם.

**לפני שאנשים אחרים יוכלו לגשת להתקנה:** 
ברירות המחדל של קובץ ה-Compose נועדו לשימוש מקומי, והן ציבוריות. לפני שאתם חושפים את המערך לרשת, צרו מפתחות אימות חדשים, הגדירו סיסמאות חדשות למסד הנתונים ולאחסון והגישו את ההתקנה ב-HTTPS. פעלו לפי הסעיף [הקשחת ההתקנה לפני שחושפים אותה](https://nodaro.ai/docs/self-hosting/install#harden-the-install-before-you-expose-it) בדף התקנה ולפי הדף [פרוקסי הפוך ו-HTTPS](https://nodaro.ai/docs/self-hosting/reverse-proxy).

## השלבים הבאים
- [התקנה](https://nodaro.ai/docs/self-hosting/install) — ההגדרה המלאה, עם שירותים מנוהלים, אחסון וסודות.
- [פרוקסי הפוך ו-HTTPS](https://nodaro.ai/docs/self-hosting/reverse-proxy) — הגשת ההתקנה בדומיין שלכם.
- [עדכון גרסה](https://nodaro.ai/docs/self-hosting/updating) — תגי אימג׳ ועדכונים.
- [גיבוי ושחזור](https://nodaro.ai/docs/self-hosting/backups) — פקודה אחת לכל כיוון.
- [פתרון בעיות](https://nodaro.ai/docs/self-hosting/troubleshooting) — כשכרטיס בדף `/setup` אדום.

## שאלות נפוצות

### כמה זמן נמשכת ההפעלה הראשונה של Nodaro באירוח עצמי?

האתחול הראשון של Nodaro באירוח עצמי מוריד את אימג׳ האפליקציה הבנוי מראש, בגודל של כ-2.4 GB, ואת השירותים שמגיעים איתו, ולכן הוא נמשך כמה דקות בחיבור רגיל. זו הורדה, לא קומפילציה. האתחולים הבאים נמשכים שניות.

### האם צריך קובץ ‎.env כדי להריץ את מהדורת Community?

לא. לכל ערך בקובץ docker-compose.community.yml יש ברירת מחדל שעובדת. צרו קובץ ‎.env רק כדי להוסיף מפתחות ספק, לשנות את הכתובת הציבורית או להשתמש בשירותים מנוהלים משלכם.

### למה ההתקנה החדשה שלי לא יכולה ליצור כלום?

להתקנה חדשה עדיין אין ספק מודלים. הדביקו מפתח ספק בדף ‎/setup, הגדירו מפתח בקובץ ‎.env או חברו את ההתקנה לחשבון Nodaro Cloud. עד שיש ספק, דף הבית מציג הודעה עם שתי האפשרויות.

### האם בטוח לחשוף לאינטרנט את ההתקנה עם הגדרות ברירת המחדל?

לא. המפתחות והסיסמאות שמוגדרים כברירת מחדל בקובץ ה-Compose הם ציבוריים. לפני שאנשים אחרים יוכלו לגשת להתקנה, צרו מפתחות אימות חדשים, הגדירו סיסמאות חדשות והגישו אותה ב-HTTPS מאחורי פרוקסי הפוך.

### כמה עולה מהדורת Community?

על מהדורת Community לא משלמים ל-Nodaro כלום. אין בה מערכת קרדיטים, אין עמלות של Nodaro ואין סימן מים. אתם משלמים ישירות לספקי המודלים שלכם, או משלמים בקרדיטים על מה שרץ דרך חיבור ל-Nodaro Cloud.