トラブルシューティング

​

トラブルシューティング

開発環境のセットアップ、バージョンアップまたはセルフホスティング中に問題が発生した場合、こちらによくある問題の解決策を示しています。

​

セルフホスティング

​

初回インストールにユーザー "postgres" のパスワード認証失敗と表示される

🚨 重要: この解決策は新規インストールの場合のみ適用されます 🚨 すでに稼働中のTwentyインスタンスに本番データがある場合、これらの手順に従うとデータベースが完全に削除されますので、絶対に従わないでください。

Twentyを初めてインストールする際には、デフォルトのデータベースパスワードを変更する必要があるかもしれません。 初回インストール時に設定されたパスワードはデータベースボリュームに永久に保存されます。 後になってこのパスワードを構成で変更しようとしても、古いボリュームを削除しない限り認証エラーが発生します。データベースが元のパスワードを使用しているためです。 初回インストール時に設定されたパスワードはデータベースボリュームに永久に保存されます。 後になってこのパスワードを構成で変更しようとしても、古いボリュームを削除しない限り認証エラーが発生します。データベースが元のパスワードを使用しているためです。 初回インストール時に設定されたパスワードはデータベースボリュームに永久に保存されます。 後になってこのパスワードを構成で変更しようとしても、古いボリュームを削除しない限り認証エラーが発生します。データベースが元のパスワードを使用しているためです。

⚠️ 警告: 以下のステップを実行すると、データベース内のすべてのデータが完全に削除されます! ⚠️ これは重要なデータのない新規インストールの場合のみ進めてください。

PG_DATABASE_PASSWORD を更新するには、次のようにする必要があります。

# 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データベースを適切なスキーマ、拡張、およびユーザーで準備する必要があります。 この準備がうまくいけば、あなたのデータベースにdefaultとmetadataスキーマがあるはずです。 そうでない場合は、同じコンピュータ上で複数のpostgresインスタンスを実行していないことを確認してください。 この準備がうまくいけば、あなたのデータベースにdefaultとmetadataスキーマがあるはずです。 そうでない場合は、お使いのコンピュータ上で複数の PostgreSQL インスタンスが実行されていないことを確認してください。

​

モジュール’twenty-emails’ またはその対応する型宣言が見つかりません。

データベースの初期化を実行する前に、20-emails パッケージ (npx nx run 20-emails:build) をビルドする必要があります。

​

twenty-xパッケージが見つかりません

ルートディレクトリでyarnを実行し、その後 npx nx server:dev twenty-serverを実行してください。 それでも動作しない場合は、足りないパッケージを手動でビルドしてみてください。 それでも動作しない場合は、足りないパッケージを手動でビルドしてみてください。 それでも動作しない場合は、足りないパッケージを手動でビルドしてみてください。

​

保存時のLintが機能しない

Oxc拡張機能 (oxc.oxc-vscode) がインストールされている場合、これは標準設定で動作するはずです。 これがうまくいかない場合は、VS Code の設定に追加してみてください (開発コンテナスコープ):

"editor.codeActionsOnSave": {

  "source.fixAll.oxc": "explicit"

}

​

npx nx start または npx nx start 21-front を実行している間、メモリ不足のエラーがスローされます

npx nx start の代わりに、必要なサービスだけを実行してください。 例えば、サーバーで作業している場合は、npx nx worker twenty-server のみを実行してください。

うまくいかない場合: WSL 上で npx nx run twenty-server:start だけを実行しようとして、以下のメモリエラーで失敗する場合:

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 フラグはNode.jsヒープの上限を8GBに設定します; 使用量はアプリケーションの要求に応じてスケールします。 参考: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048 参考: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048 参考: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048

動作しない場合: マシンのRAMをほとんど消費しているプロセスを調査します。 Twentyでは、一部のVS Code拡張モジュールが多くのRAMを消費していることに気づいたため、一時的に無効にしました。

動作しない場合: マシンを再起動すると、ゴーストプロセスのクリーンアップができます。

​

npx nx startを実行中にログに謎の[0]や[1]が表示される

npx nx startコマンドが複数のコマンドを裏で実行しているため、これは予想された挙動です。

​

メールが送信されない

ほとんどの場合、バックグラウンドでworkerが動作していないのが原因です。 実行してみてください 実行してみてください 実行してみてください

npx nx worker twenty-server

​

Microsoft 365 アカウントを Twenty に接続できません

ほとんどの場合、管理者があなたのアカウントのMicrosoft 365ライセンスを有効化していないことが原因です。 https://admin.microsoft.com/を確認してください。 https://admin.microsoft.com/を確認してください。 https://admin.microsoft.com/を確認してください。

エラーコードAADSTS50020を受け取った場合、おそらく個人のMicrosoftアカウントを使用しています。 これはまだサポートされていません。 エラーコードAADSTS50020を受け取った場合、おそらく個人のMicrosoftアカウントを使用しています。 これはまだサポートされていません。 エラーコードAADSTS50020を受け取った場合、おそらく個人のMicrosoftアカウントを使用しています。 これはまだサポートされていません。 詳細はこちら

​

yarn を実行中にコンソールに警告が表示されます

警告は、package.jsonに明示的に記載されていない追加依存関係の取得を伝えており、破損するエラーがない限り、すべてが期待通りに動作するはずです。

​

ユーザーがログインページにアクセスすると、ワークスペースにアクセスしようとする権限のないユーザーに関するエラーがログに表示されます。

ユーザーの身元が確認されていないので、ログアウト時にユーザーが許可されていないと予想されます。

​

ワーカーが稼働しているかどうかを確認するには?

• webhook-test.comにアクセスし、Your Unique Webhook URLをコピーします。

• Twentyアプリを開き、/settingsに移動し、画面左下のAdvancedトグルを有効にします。
• 新しいWebhookを作成します。
• Your Unique Webhook URLをTwentyのEndpoint Urlフィールドに貼り付けます。 FiltersをCompaniesとCreatedに設定します。

• /objects/companiesにアクセスし、新しい企業レコードを作成します。
• webhook-test.comに戻り、新しいPOSTリクエストが受信されたか確認します。

• POSTリクエストが受信された場合、あなたのワーカーは正常に稼働しています。 そうでない場合は、ワーカーのトラブルシューティングが必要です。

​

フロントエンドの起動に失敗し、エラーが返される TS5042: オプション「プロジェクト」をコマンドラインのソースファイルと混在させることはできません

以下の例に示すように、packages/21ui/vite-config.tsのチェッカープラグインにコメントしてください。

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'],
        },
      }),
    ],

​

管理パネルにアクセスできない

UPDATE core."user"を実行します。 SET "canAccessFullAdminPanel" = TRUE WHEREメール = '[e-mail]';は、管理パネルにアクセスするためのデータベースコンテナにあります。

​

ワークフローを実行すると、エラー「ロジック関数の実行は無効です。 有効にするには LOGIC_FUNCTION_TYPE を LOCAL または LAMBDA に設定してください。」

本番環境では、ロジック関数はデフォルトで無効になっています。 有効にするには、LOGIC_FUNCTION_TYPE 環境変数を LOCAL または LAMBDA に設定します。 これは、環境変数経由、または管理画面のデータベース変数から設定できます。 詳細はロジック関数のセットアップガイドを参照してください。

​

AIチャットでメッセージを入力すると、すぐには答えられず、答えを見るためにページを更新する必要があります。

つまり、リバースプロキシはストリームベースの API 応答の構成を欠落しています。 以下は 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;
}

​

Docker Compose 1-click

​

ログインできない

セットアップ後にログインできない場合:

1. 次のコマンドを実行してください:
   docker exec -it twenty-server-1 yarn
   docker exec -it twenty-server-1 npx nx database:reset  --configuration=no-seed
   
2. Dockerコンテナを再起動してください:
   docker compose down
   docker compose up -d
   

database:reset コマンドはデータベースを完全に消去し、最初から再作成します。

​

リバースプロキシの背後での接続問題

リバースプロキシの背後でTwentyを実行し、接続問題が発生している場合:

1. SERVER_URLの確認:

   .envファイルのSERVER_URLが外部アクセスURLと一致するようにし、SSLが有効ならhttpsを含めます。

2. リバースプロキシ設定の確認:

   • リバースプロキシがTwentyサーバーへのリクエストを正しく転送していることを確認してください。
   • X-Forwarded-ForやX-Forwarded-Protoといったヘッダーが正しく設定されていることを確認してください。

3. サービスの再起動:

   変更を行った後に、リバースプロキシとTwentyコンテナの両方を再起動します。

​

画像のアップロード時にエラー - アクセス許可が拒否されました

ホストでのデータフォルダの所有権をrootから他のユーザーとグループに切り替えると、この問題が解決されます。

​

サポートを受ける

このガイドにカバーされていない問題がある場合:

• ログを確認:

  コンテナログを表示してエラーメッセージを確認します:

  docker compose logs
  

• コミュニティサポート:

  Twentyコミュニティまたはサポートチャンネルに連絡してサポートを受けてください。