twenty/packages/twenty-docs/l/he/developers/self-hosting/troubleshooting.mdx

---
title: פתרון תקלות
image: /images/user-guide/what-is-twenty/20.png
---

<Frame>
  <img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
</Frame>

## פתרון תקלות

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

### אירוח עצמי

#### First install results in `password authentication failed for user "postgres"`

🚨 **חשוב: פתרון זה מתאים רק להתקנות חדשות** 🚨
אם יש לך כבר מקרה Twenty עם נתוני ייצור, **אל** תעקוב אחר שלבים אלו כי הם ימחקו לצמיתות את המאגר שלך!

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

⚠️ **אזהרה: שלבים הבאים ימחקו לצמיתות את כל נתוני המאגר!** ⚠️
המשך רק אם זו התקנה חדשה ללא נתונים חשובים.

In order to update the `PG_DATABASE_PASSWORD` you need to:

```sh
# Update the PG_DATABASE_PASSWORD in .env
docker compose down --volumes
docker compose up -d
```

#### נמצאו שבירות קו CR [Windows]

זה נובע מתווים שוברים קו של Windows ומקונפיגורציה של git. נסה להריץ:

```
git config --global core.autocrlf false
```

Then delete the repository and clone it again.

#### סכימת מטא נתונים חסרה

במהלך התקנת Twenty, עליך לספק את מאגר postgres שלך עם הסכימות, התוספות והמשתמשים הנכונים.
אם הצלחת לבצע את ההתקנה הזו, עליך לקבל סכימות `default` ו-`metadata` במאגר שלך.
אם לא, ודא שאין לך יותר ממקרה postgres אחד פועל במחשב שלך.

#### לא ניתן למצוא את המודול 'twenty-emails' או את ההצהרות הסוג המתאימות שלו.

עליך לבנות את החבילה `twenty-emails` לפני הרצת ההכנה של המאגר עם `npx nx run twenty-emails:build`.

#### חבילת twenty-x חסרה

ודא להריץ yarn בתיקיית השורש ולאחר מכן להריץ `npx nx server:dev twenty-server`.  אם זה עדיין לא עובד, נסה לבנות את החבילה החסרה באופן ידני.

#### הבדיקה על שמירה אינה פועלת

זה אמור לעבוד ישר מהקופסה עם תוסף eslint המותקן.  אם זה לא עובד נסה להוסיף את זה להגדרות שלך ב-vscode (בתחום מיכל הפיתוח):

```
"editor.codeActionsOnSave": {

  "source.fixAll.eslint": "explicit"

}
```

#### בעת הרצת `npx nx start` או `npx nx start twenty-front`, מופיעה שגיאה של מחסור בזיכרון

In `packages/twenty-front/.env` uncomment `VITE_DISABLE_TYPESCRIPT_CHECKER=true` and `VITE_DISABLE_ESLINT_CHECKER=true` to disable background checks thus reducing amount of needed RAM.

**אם זה לא עובד:**
הרץ רק את השירותים שאתה צריך, במקום `npx nx start`. למשל, אם אתה עובד על השרת, הרץ רק `npx nx worker twenty-server`.

**אם זה לא עובד:**
אם ניסית להפעיל רק `npx nx run twenty-server:start` ב-WSL ולא הצלחת בגלל שגיאת זיכרון להלן:

`FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory`

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

`export NODE_OPTIONS="--max-old-space-size=8192"`

התווית --max-old-space-size=8192 קובעת גבול עליון של 8GB לערמה של Node.js; השימוש נסק עם צרכי האפליקציה.
ראה: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048

**אם זה לא עובד:**
בדוק אילו תהליכים לוקחים לך את מירב הזיכרון RAM במכונה שלך. ב־Twenty, שמנו לב שכמה תוספות של VScode לקחו הרבה RAM ולכן השבתנו אותן באופן זמני.

**אם זה לא עובד:**
הפעל מחדש את המחשב עוזר לנקות תהליכים אבודים.

#### בעת הרצת `npx nx start` יש רשומות תמוהות של [0] ו-[1] ביומנים

זה צפוי מכיוון שהפקודה `npx nx start` מריצה יותר פקודות מאחורי הקלעים

#### אין מיילים שנשלחים

רוב הזמן, זה בגלל שה-`worker` לא פועל ברקע. נסה להריץ

```
npx nx worker twenty-server
```

#### לא מצליח לחבר את חשבון Microsoft 365 שלי

רוב הזמן, זה בגלל שהמנהל שלך לא הפעיל את הרישיון Microsoft 365 עבור החשבון שלך. בדוק [https://admin.microsoft.com/](https://admin.microsoft.com/Adminportal/Home).

אם יש לך קוד שגיאה `AADSTS50020`, כנראה שאתה משתמש בחשבון Microsoft אישי. זה עדיין לא נתמך. מידע נוסף [כאן](https://learn.microsoft.com/fr-fr/troubleshoot/entra/entra-id/app-integration/error-code-aadsts50020-user-account-identity-provider-does-not-exist).

#### במהלך הרצת `yarn` מופיעות אזהרות במסוף

האזהרות מודיעות על משיכת תלות נוספות שאינן מצוינות בצורה מפורשת ב־`package.json`, ולכן כל עוד לא מופיעה שגיאה קריטית, הכל צריך לעבוד כמצופה.

#### When user accesses login page, error about unauthorized user trying to access workspace appears in logs

That's expected as user is unauthorized when logged out since its identity is not verified.

#### איך לבדוק אם ה-Worker שלך פועל?

- גש ל-[webhook-test.com](https://webhook-test.com/) והעתק **כתובת האתר הייחודית של ה-Webhook שלך**.

<div style={{textAlign: 'center'}}>
  <img src="/images/docs/developers/self-hosting/webhook-test.jpg" alt="Webhook test" />
</div>
- פתח את האפליקציה של Twenty, נווט ל-`/settings`, והפעל את המתג **מתקדם** בפינה השמאלית התחתונה של המסך.
- Create a new webhook.
- הדבק את **כתובת האתר הייחודית של ה-Webhook שלך** בשדה **Endpoint Url** ב-Twenty. הגדר את ה-**מסננים** ל`Companies` ו`Created`.
<div style={{textAlign: 'center'}}>
  <img src="/images/docs/developers/self-hosting/webhook-settings.jpg" alt="Webhook settings" />
</div>
- Go to `/objects/companies` and create a new company record.
- Return to [webhook-test.com](https://webhook-test.com/) and check if a new **POST request** has been received.
<div style={{textAlign: 'center'}}>
  <img src="/images/docs/developers/self-hosting/webhook-test-result.jpg" alt="Webhook test result" />
</div>
- אם התקבלה בקשת **POST**, ה-Worker שלך פועל בהצלחה. אחרת יש לפתור תקלות ב-Worker שלך.

#### Front-end fails to start and returns error TS5042: Option 'project' cannot be mixed with source files on a command line

Comment out checker plugin in `packages/twenty-ui/vite-config.ts` like in example below

```
plugins: [
      react({ jsxImportSource: '@emotion/react' }),
      tsconfigPaths(),
      svgr(),
      dts(dtsConfig),
      // checker(checkersConfig),
      wyw({
        include: [
          '**/OverflowingTextWithTooltip.tsx',
          '**/Chip.tsx',
          '**/Tag.tsx',
          '**/Avatar.tsx',
          '**/AvatarChip.tsx',
        ],
        babelOptions: {
          presets: ['@babel/preset-typescript', '@babel/preset-react'],
        },
      }),
    ],
```

#### פאנל הניהול אינו נגיש

הרץ את `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = 'you@yourdomain.com';` במיכל הנתונים על מנת לקבל גישה לפאנל הניהול.

### חד-קליק Docker compose

#### לא ניתן להתחבר

אם אינך יכול להתחבר לאחר ההתקנה:

1. הרץ את הפקודות הבאות:
   ```bash
   docker exec -it twenty-server-1 yarn
   docker exec -it twenty-server-1 npx nx database:reset  --configuration=no-seed
   ```
2. הפעל מחדש את מיכלי Docker:
   ```bash
   docker compose down
   docker compose up -d
   ```

שים לב שהפקודה database:reset תמחק לחלוטין את המאגר שלכם ותבנה אותו מחדש מהתחלה.

#### בעיות חיבור מאחורי פרוקסי הפוך

אם אתם מריצים Twenty מאחורי פרוקסי הפוך ויש בעיות חיבור:

1. **בדוק את SERVER_URL:**

   ודאו ש-`SERVER_URL` בקובץ ה-`.env` שלכם תואם את כתובת הגישה החיצונית כולל `https` אם SSL מופעל.

2. **בדוק את הגדרות הפרוקסי ההפוך:**

   - וודא שהפרוקסי ההפוך שלכם מפנה נכון את הבקשות לשרת של Twenty.
   - ודא ש-headers כמו `X-Forwarded-For` ו-`X-Forwarded-Proto` מוגדרים כראוי.

3. **הפעל מחדש את השירותים:**

   לאחר ביצוע שינוי, הפעל מחדש את שני הפרוקסי ההפוך ומיכלי Twenty.

#### שגיאה בעת העלאת תמונה - גישה נדחית

המעבר בין בעלות על תיקיית הנתונים בשרת משורש למשתמש וקבוצה אחרים פותר בעיה זו.

## קבלת עזרה

אם אתם נתקלים בבעיות שלא כלולות במדריך זה:

- בדקו את היומנים:

  הציגו את היומנים של מיכל הנתונים עבור הודעות שגיאה:

  ```bash
  docker compose logs
  ```

- תמיכה קהילתית:

  פנו לקהילה של [Twenty](https://github.com/twentyhq/twenty/issues) או ערוצי התמיכה [support channels](https://discord.gg/cx5n4Jzs57) לקבלת עזרה.