Created by Github action --------- Co-authored-by: Crowdin Bot <support+bot@crowdin.com> Co-authored-by: github-actions <github-actions@twenty.com>
226 lines
13 KiB
Plaintext
226 lines
13 KiB
Plaintext
---
|
||
title: Решавање проблема
|
||
image: /images/user-guide/what-is-twenty/20.png
|
||
---
|
||
|
||
<Frame>
|
||
<img src="/images/user-guide/what-is-twenty/20.png" alt="Header" />
|
||
</Frame>
|
||
|
||
## Решавање проблема
|
||
|
||
Ако наиђете на било који проблем током подешавања окружења за развој, надоградње инстанце или самосталног хостовања, ево неких решења за уобичајене проблеме.
|
||
|
||
### Самостално хостовање
|
||
|
||
#### Прва инсталација резултује грешком `верификација лозинке није успела за корисника "postgres"`
|
||
|
||
🚨 **ВАЖНО: Ово решење је САМО за свеже инсталације** 🚨
|
||
Ако већ имате инстанцу Twenty са продукцијским подацима, **НИ У КОМ СЛУЧАЈУ НЕ** следите ове кораке, јер ће они трајно обрисати вашу базу података!
|
||
|
||
Док први пут инсталирате Twenty, можда ћете желети да промените подразумевану лозинку за базу података.
|
||
Лозинка коју подесите током прве инсталације постаје трајно сачувана у запремини базе. Ако касније покушате променити ову лозинку у вашој конфигурацији без уклањања старе запремине, добићете грешке у верификацији јер база података и даље користи оригиналну лозинку.
|
||
|
||
⚠️ УПОЗОРЕЊЕ: Следећи кораци ће ТРАЈНО ОБРИСАТИ све податке у бази података! ⚠️
|
||
Наставите само ако је ово свеже инсталирање без важних података.
|
||
|
||
Да бисте ажурирали `PG_DATABASE_PASSWORD`, потребно је:
|
||
|
||
```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
|
||
```
|
||
|
||
Затим обришите репозиторијум и поново га клонирајте.
|
||
|
||
#### Недостаје шема метаподатака
|
||
|
||
Током инсталације Twenty, потребно је да обезбедите своју postgres базу са одговарајућим шемама, проширењима и корисницима.
|
||
Ако успешно извршите ову операцију, требало би да имате `подразумевано` и `метаподаци` шеме у вашој бази.
|
||
Ако их немате, уверите се да нема више од једне инстанце postgres-а која ради на вашем рачунару.
|
||
|
||
#### Не могу пронаћи модул 'twenty-emails' или његове одговарајуће типске декларације.
|
||
|
||
Морате изградити пакет `twenty-emails` пре покретања иницијализације базе података са `npx nx run twenty-emails:build`
|
||
|
||
#### Недостаје пакет twenty-x
|
||
|
||
Уверите се да сте покренули yarn у основном директоријуму и затим покрените `npx nx server:dev twenty-server`. Ако ово и даље не функционише, пробајте ручно изградити недостајући пакет.
|
||
|
||
#### Lint на саве не ради
|
||
|
||
Ово би требало да ради из кутије са инсталираним eslint проширењем. Ако ово не ради, покушајте да додате ово у ваша vscode подешавања (у опсегу dev контејнера):
|
||
|
||
```
|
||
"editor.codeActionsOnSave": {
|
||
|
||
"source.fixAll.eslint": "explicit"
|
||
|
||
}
|
||
```
|
||
|
||
#### Док покрећете `npx nx start` или `npx nx start twenty-front`, јавља се грешка недостатка меморије
|
||
|
||
У `packages/twenty-front/.env` одкоментаришите `VITE_DISABLE_TYPESCRIPT_CHECKER=true` и `VITE_DISABLE_ESLINT_CHECKER=true` да онемогућите проверу у позадини и тако смањите потребну количину RAM-a.
|
||
|
||
**Ако не ради:**
|
||
Покрените само оне услуге које су вам потребне, уместо `npx nx start`. На пример, ако радите на серверу, покрените само `npx nx worker twenty-server`
|
||
|
||
**Ако не ради:**
|
||
Ако сте покушали да покренете само `npx nx run twenty-server:start` на WSL и не ради са грешком недостатка меморије:
|
||
|
||
`ФАТАЛНА ГРЕШКА: Неделотворно компактирање означака близу ограничења хипа неуспех у додељивању - ЈаваСцрипт хип је остао без меморије`
|
||
|
||
Обилазно решење је да извршите следећу команду у терминалу или да је додате у .bashrc профил да се аутоматски подеси:
|
||
|
||
`export NODE_OPTIONS="--max-old-space-size=8192"`
|
||
|
||
Опција --max-old-space-size=8192 одређује горњу границу хипа Node.js-а од 8 ГБ; коришћење се скалира према захтевима апликације.
|
||
Референца: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048
|
||
|
||
**Ако не ради:**
|
||
Истражите који процеси вам заузимају већину меморије рачунара. У Twenty, приметили смо да нека проширења VScode значајно троше RAM, па их привремено искључујемо.
|
||
|
||
**Ако не ради:**
|
||
Поново покрените рачунар како бисте очистили привремене процесе.
|
||
|
||
#### Док покрећете `npx nx start`, појављују се чудни [0] и [1] у логовима
|
||
|
||
То је очекивано, јер команда `npx nx start` покреће више команди у позадини
|
||
|
||
#### Не шаљу се имејлови
|
||
|
||
У већини случајева, то је зато што `радник` не ради у позадини. Покушајте да покренете
|
||
|
||
```
|
||
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`, па докле год се не појављује критична грешка, све би требало да функционише очекивано.
|
||
|
||
#### Када корисник приступи страници за пријављивање, појављује се грешка о неовлашћеном кориснику који покушава да приступи радном простору у логовима
|
||
|
||
Очекивано је да је корисник неовлашћен када је одјављен, пошто његов идентитет није верификован.
|
||
|
||
#### Како проверити да ли ваш радник ради?
|
||
|
||
- Идите на [webhook-test.com](https://webhook-test.com/) и копирајте **Ваш јединствени URL вебхука**.
|
||
|
||
<div style={{textAlign: 'center'}}>
|
||
<img src="/images/docs/developers/self-hosting/webhook-test.jpg" alt="Webhook test" />
|
||
</div>
|
||
- Отворите вашу апликацију Twenty, идите у `/settings`, и омогућите **Напредно** пребацивање на дно лево од екрана.
|
||
- Креирајте нови вебхук.
|
||
- Налепите **Ваш јединствени URL вебхука** у поље **URL крајње тачке** у Twenty. Подесите **Филтри** на `Компаније` и `Креирано`.
|
||
<div style={{textAlign: 'center'}}>
|
||
<img src="/images/docs/developers/self-hosting/webhook-settings.jpg" alt="Webhook settings" />
|
||
</div>
|
||
- Идите на `/objects/companies` и креирајте нови запис компаније.
|
||
- 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 захтев**, ваш радник успешно ради. У супротном, треба да решавате проблем са вашим радником.
|
||
|
||
#### 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';` у контејнеру базе да добијете приступ админ панелу.
|
||
|
||
### 1-click Docker compose
|
||
|
||
#### Unable to Log In
|
||
|
||
Ако се не можете пријавити након постављања:
|
||
|
||
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` датотеци одговара вашој URL адреси за спољни приступ, укључујући `https` ако је SSL омогућен.
|
||
|
||
2. **Проверите подешавања реверзног проксија:**
|
||
|
||
- Потврдите да ваш реверзни прокси исправно прослеђује захтеве ка Twenty серверу.
|
||
- Уверите се да су заглавља попут `X-Forwarded-For` и `X-Forwarded-Proto` правилно подешена.
|
||
|
||
3. **Поново покрените услуге:**
|
||
|
||
Након измена, поново покрените и реверзни прокси и Twenty контејнере.
|
||
|
||
#### Грешка приликом отпремања слике - одбијен приступ
|
||
|
||
Промена власништва над фасциклом података на домаћину са root на другог корисника или групу решава овај проблем.
|
||
|
||
## Добијање помоћи
|
||
|
||
Ако наиђете на проблеме који нису покривени овим водичем:
|
||
|
||
- Проверите логове:
|
||
|
||
Погледајте логове контејнера за поруке о грешкама:
|
||
|
||
```bash
|
||
docker compose logs
|
||
```
|
||
|
||
- Подршка заједнице:
|
||
|
||
Обратите се [Twenty заједници](https://github.com/twentyhq/twenty/issues) или [каналима за подршку](https://discord.gg/cx5n4Jzs57) за помоћ. |