--- title: Řešení potíží image: /images/user-guide/what-is-twenty/20.png --- Header ## Řešení potíží If you encounter any problem while setting up environment for development, upgrading your instance or self-hosting, here are some solutions for common problems. ### Vlastní hosting #### First install results in `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. K aktualizaci `PG_DATABASE_PASSWORD` musíte: ```sh # Update the PG_DATABASE_PASSWORD in .env docker compose down --volumes docker compose up -d ``` #### CR line breaks found [Windows] This is due to the line break characters of Windows and the git configuration. 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 ne, ujistěte se, že na vašem počítači neběží více než jedna instance postgres. #### Cannot find module 'twenty-emails' or its corresponding type declarations. Před spuštěním inicializace databáze musíte sestavit balíček `twenty-emails` s `npx nx run twenty-emails: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 eslint. If this doesn't work try adding this to your vscode setting (on the dev container scope): ``` "editor.codeActionsOnSave": { "source.fixAll.eslint": "explicit" } ``` #### Při spuštění `npx nx start` nebo `npx nx start twenty-front` došlo k chybě nedostatku paměti 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. **Pokud to nefunguje:** 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 pouze spustit `npx nx run twenty-server:start` na WSL a došlo k chybě nízké paměti: `FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory` Pro obejití proveďte níže uvedený příkaz v terminálu nebo jej přidejte do profilu .bashrc, aby se automatizovalo nastavení: `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:** Analyzujte, které procesy vám zabírají většinu paměti na stroji. V Twenty jsme si všimli, že některá rozšíření VScode zabírala hodně paměti RAM, takže jsme je dočasně deaktivovali. **Pokud to nefunguje:** Restartování stroje pomáhá vyčistit „ghost“ 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 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 v konzoli objevují varování 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řistoupí na přihlašovací stránku, v protokolech se objeví chybová zpráva o neautorizovaném uživateli, který se snaží přistoupit k pracovnímu prostoru To je očekávané, protože uživatel je neautorizovaný, když je odhlášen, protože jeho identita není 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**.
Webhook test
- Open your Twenty app, navigate to `/settings`, and enable the **Advanced** toggle at the bottom left of the screen. - Vytvořte nový webhook. - Vložte **Svou unikátní webhook URL** do pole **Endpoint Url** ve Twenty. Nastavte **Filtry** na `Companies` a `Created`.
Webhook settings
- Přejděte na `/objects/companies` a vytvořte nový záznam společnosti. - Return to [webhook-test.com](https://webhook-test.com/) and check if a new **POST request** has been received.
Webhook test result
- 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 nedaří spustit a vrací chybu TS5042: Možnost 'project' nelze kombinovat se zdrojovými soubory na příkazovém řádku 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'], }, }), ], ``` #### Administrační panel není přístupný Spusťte `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = 'you@yourdomain.com';` v databázovém kontejneru pro získání přístupu k administračnímu panelu. ### 1-click Docker compose #### 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 ``` Poznámka: příkaz database:reset kompletně smaže vaši databázi a vytvoří ji znovu od základu. #### 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. #### Error when uploading an image - permission denied Switching the data folder ownership on the host from root to another user and group resolves this problem. ## Získání pomoci Pokud se setkáte s problémy, které tento průvodce nepokrývá: - Zkontrolujte protokoly: View container logs for error messages: ```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.