Ř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. K aktualizaci PG_DATABASE_PASSWORD musíte:

# Aktualizovat PG_DATABASE_PASSWORD ve .env
docker compose down --volumes
docker compose up -d

Nalezeny konce řádků CR [Windows]

Je to způsobeno znaky konce řádku ve Windows a konfigurací gitu. 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.

Nelze najít modul ‘twenty-emails’ ani jeho odpovídající deklarace typů.

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. Pokud to nefunguje, zkuste přidat toto do svého nastavení vscode (v rozsahu dev containeru):

"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 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 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í počítače pomůže vyčistit zombie 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/. 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

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 a zkopírujte Svou unikátní webhook URL.

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.

Přejděte na /objects/companies a vytvořte nový záznam společnosti.
Vraťte se na webhook-test.com a zkontrolujte, zda byla přijata nová POST request.

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

Zakomentujte plugin checker v packages/twenty-ui/vite-config.ts jako v příkladu níže

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.

Docker Compose jedním kliknutím

Nelze se přihlásit

Pokud se nemůžete přihlásit po nastavení:

Spusťte následující příkazy:

docker exec -it twenty-server-1 yarn
docker exec -it twenty-server-1 npx nx database:reset --configuration=no-seed

Restartujte Docker kontejnery:
```
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:

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.
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.
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:
```
docker compose logs
```
Podpora komunity: Obraťte se na komunitu Twenty nebo podpůrné kanály pro pomoc.

Vývojáři

Rozšíření

Vlastní hosting

Přispět

Řešení potíží