--- title: Řešení potíží icon: wrench --- ## Řešení potíží Pokud narazíte na jakýkoli problém při nastavování prostředí pro vývoj, při aktualizaci své instance nebo při samostatném hostování, zde jsou některá řešení běžných problémů. ### Vlastní hosting #### První instalace skončí chybou `password authentication failed for user "postgres"` 🚨 **DŮLEŽITÉ: Toto řešení je POUZE pro nové instalace** 🚨 Pokud máte existující instanci Twenty s produkčními daty, **NEPROVÁDĚJTE** tyto kroky, protože trvale smažou vaši databázi! Při první instalaci Twenty můžete chtít změnit výchozí heslo pro databázi. Heslo, které nastavíte během první instalace, se stane trvale uloženým v objemu databáze. Pokud se později pokusíte toto heslo změnit v konfiguraci, aniž byste odstranili starý objem, dojde k chybám autentizace, protože databáze stále používá původní heslo. ⚠️ VAROVÁNÍ: Následující kroky trvale SMAŽÍ veškerá data z databáze! ⚠️ Pokračujte pouze v případě, že se jedná o novou instalaci bez důležitých dat. Chcete-li aktualizovat `PG_DATABASE_PASSWORD`, potřebujte: ```sh # Update the PG_DATABASE_PASSWORD in .env docker compose down --volumes docker compose up -d ``` #### Nalezeny konce řádků CR [Windows] K tomu dochází díky znakům s liniovým jádrem Windows v kombinaci s konfigurací Git. Zkuste spustit: ``` git config --global core.autocrlf false ``` Pak smažte úložiště a naklonujte jej znovu. #### Chybí schéma metadat Během instalace Twenty musíte nastavit svou postgres databázi s správnými schématy, rozšířeními a uživateli. Pokud se vám podaří spustit toto nastavování, měli byste mít ve své databázi schémata `default` a `metadata`. Pokud nemáte, ujistěte se, že na vašem počítači není spuštěna více než jedna PostgreSQL instance. #### Nelze najít modul 'twenty-emails' ani jeho odpovídající deklarace typů. Před inicializací databáze musíte vytvořit balíček `dvacet e-mailů` (`npx nx spustit dvacet e-mailů:build`). #### Chybí balíček twenty-x Ujistěte se, že v kořenovém adresáři spouštíte `yarn` a poté spusťte `npx nx server:dev twenty-server`. Pokud stále nefunguje, zkuste chybějící balíček sestavit ručně. #### Lint při ukládání nefunguje Toto by mělo fungovat přímo s nainstalovaným rozšířením Oxc (`oxc.oxc-vscode`). Pokud to nefunguje, zkuste to přidat do nastavení VS kódu (rozsah dev kontejneru): ``` "editor.codeActionsOnSave": { "source.fixAll.oxc": "explicit" } ``` #### Při běhu `npx nx start` nebo `npx nx start 21 front`, je vyhozena chyba mimo paměť Spusťte pouze služby, které potřebujete, místo `npx nx start`. Například pokud pracujete na serveru, spusťte pouze `npx nx worker twenty-server` **Pokud to nefunguje:** Pokud jste se pokusili spustit pouze `npx nx run twenty-server:start` na WSL a selhává to s následující chybou paměti: `FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory` Práce je spustit následující příkaz v terminálu, nebo ho přidat do profilu `.bashrc` tak, aby byl použit automaticky: `export NODE_OPTIONS="--max-old-space-size=8192"` Příznak --max-old-space-size=8192 nastavuje horní limit 8 GB pro hromadu v Node.js; využití se škáluje s požadavkem aplikace. Odkaz: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048 **Pokud to nefunguje:** Zjistit, které procesy přebírají většinu RAM. Ve dvaceti letech jsme si všimli, že některá rozšíření VS kódu zabírala spoustu RAM, takže jsme je dočasně zakázali. **Pokud to nefunguje:** Restartování zařízení pomáhá vyčistit ducha procesy. #### Při běhu `npx nx start` se v protokolech objevují podivné [0] a [1] To je očekávané, protože příkaz `npx nx start` spouští více příkazů v pozadí #### E-maily nejsou odesílány Většinou je to proto, že `worker` neběží na pozadí. Zkuste spustit ``` npx nx worker twenty-server ``` #### Nelze připojit můj účet Microsoft 365 k dvaceti Většinou je to proto, že váš administrátor pro váš účet nepovolil licenci Microsoft 365. Zkontrolujte [https://admin.microsoft.com/](https://admin.microsoft.com/Adminportal/Home). Pokud máte chybový kód `AADSTS50020`, pravděpodobně používáte osobní účet Microsoft. Tento přístup ještě není podporován. Více informací [zde](https://learn.microsoft.com/fr-fr/troubleshoot/entra/entra-id/app-integration/error-code-aadsts50020-user-account-identity-provider-does-not-exist) #### Při běhu `yarn` se varování zobrazí v konzoli Varování informují o načítání dalších závislostí, které nejsou explicitně uvedeny v `package.json`, takže pokud se neobjeví žádná vážná chyba, vše by mělo fungovat podle očekávání. #### Když uživatel přistupuje na přihlašovací stránku, objeví se v záznamech chyba o neautorizovaném uživateli, který se snaží získat přístup k pracovnímu prostoru To je očekáváno jako uživatel je neautorizovaný při odhlášení, protože jeho identita nebyla ověřena. #### Jak zkontrolovat, zda váš worker běží? * Jděte na [webhook-test.com](https://webhook-test.com/) a zkopírujte **Svou unikátní webhook URL**.
Test webhooku
* Otevřete svou Twenty aplikaci, přejděte na `/settings` a na levé dolní části obrazovky aktivujte přepínač **Pokročilé**. * Vytvořte nový webhook. * Vložte **Svou unikátní webhook URL** do pole **Endpoint Url** ve Twenty. Nastavte **Filtry** na `Companies` a `Created`.
Nastavení webhooku
* Přejděte na `/objects/companies` a vytvořte nový záznam společnosti. * Vraťte se na [webhook-test.com](https://webhook-test.com/) a zkontrolujte, zda byla přijata nová **POST request**.
Výsledek testu webhooku
* Pokud byla přijata **POST request**, váš worker běží úspěšně. V opačném případě je potřeba zkontrolovat váš worker. #### Front-end se nespustí a chyba vrátí TS5042: Možnost 'project' nemůže být smíchána se zdrojovými soubory na příkazové řádce Komentář kontrolního skriptu v `packages/twenty-ui/vite-config.ts`, jak je zobrazen v příkladu níže: ``` plugins: [ react({ jsxImportSource: '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'], }, }), ], ``` #### Administrační panel není přístupný Spusťte `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = 'you@yourdomain.com';` v databázovém kontejneru, abyste získali přístup k administrátorskému panelu. #### Při spuštění workflow dojde k chybě "Logic function execution is disabled. Set LOGIC_FUNCTION_TYPE to LOCAL or LAMBDA to enable." V produkčním prostředí jsou logické funkce ve výchozím nastavení zakázané. Nastavte proměnnou prostředí `LOGIC_FUNCTION_TYPE` na `LOCAL` nebo `LAMBDA`, abyste je povolili. Toto lze nakonfigurovat pomocí proměnných prostředí nebo prostřednictvím proměnných databáze v administračním panelu. Podrobnosti najdete v [průvodci nastavením Logic Functions](/l/cs/developers/self-host/capabilities/setup#logic-functions-available-drivers). #### Když napíšu zprávu v AI chatu, neodpoví okamžitě a musím aktualizovat stránku, abych viděl odpověď To znamená, že vaší reverzní proxy chybí konfigurace pro streamované API odpovědi. Níže je uveden příklad konfigurace Nginx: ``` location ~* ^/api/.*stream|\/graphql\/stream { proxy_pass http://twenty_backend; proxy_http_version 1.1; proxy_set_header Connection ""; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_buffering off; proxy_request_buffering off; proxy_cache off; gzip off; #chunked_transfer_encoding off; add_header X-Accel-Buffering no always; } ``` ### Sestavení Dockeru #### Nelze se přihlásit Pokud se nemůžete přihlásit po nastavení: 1. Spusťte následující příkazy: ```bash docker exec -it twenty-server-1 yarn docker exec -it twenty-server-1 npx nx database:reset --configuration=no-seed ``` 2. Restartujte Docker kontejnery: ```bash docker compose down docker compose up -d ``` Všimněte si, že příkaz `database:reset` zcela vymaže databázi a znovu ji obnoví od nuly. #### Problémy s připojením za reverzní proxy Pokud provozujete Twenty za reverzní proxy a máte problémy s připojením: 1. **Ověřte SERVER_URL:** Ujistěte se, že `SERVER_URL` ve vašem `.env` souboru odpovídá vaší externí přístupové URL, včetně `https`, pokud je SSL povoleno. 2. **Zkontrolujte nastavení reverzní proxy:** * Potvrďte, že vaše reverzní proxy správně směruje požadavky na server Twenty. * Ujistěte se, že záhlaví jako `X-Forwarded-For` a `X-Forwarded-Proto` jsou správně nastaveny. 3. **Restartujte služby:** Po provedení změn restartujte jak reverzní proxy, tak kontejnery Twenty. #### Chyba při nahrávání obrázku - přístup odepřen Změna vlastnictví datové složky na hostiteli z uživatele root na jiného uživatele a skupinu tento problém vyřeší. ## Získání pomoci Pokud se setkáte s problémy, které tento průvodce nepokrývá: * Zkontrolujte protokoly: Zobrazte protokoly kontejneru kvůli chybovým zprávám: ```bash docker compose logs ``` * Podpora komunity: Obraťte se na [komunitu Twenty](https://github.com/twentyhq/twenty/issues) nebo [podpůrné kanály](https://discord.gg/cx5n4Jzs57) pro pomoc.