メール配信を設定する

メールは、KolleKがブラウザセッションの外にいる人に届く手段です。招待、マジックリンク、パスワードリセット、メール確認、セキュリティ通知は、すべてメールで届きます。配信を設定するまで、これらはどこにも届きません。

デフォルトでは何も送信されない

新規インスタンスはMAIL_MAILER=logの状態で出荷されます。すべてのメールは、送信される代わりにアプリケーションログファイルに書き込まれます。これは意図的な仕様です。設定が半端なインスタンスが、誤ったアドレスから気づかないうちにメールを送ってしまうことを防ぎ、テスト中には何が送信されるはずだったかを正確に確認できます。

実際にメールを送信する方法は2つサポートされています。任意のSMTPサーバーか、Resendサービスです。

方法1: SMTP

MAIL_MAILER=smtp
MAIL_HOST=smtp.yourprovider.com
MAIL_PORT=587
MAIL_USERNAME=your-username
MAIL_PASSWORD=your-password

MAIL_FROM_ADDRESS=kollek@yourdomain.com
MAIL_FROM_NAME="KolleK"

docker compose up -d

方法2: Resend

Resendを使う場合は、次のように設定します。

USE_RESEND=true
RESEND_API_KEY=re_your_api_key

これにより、メールはSMTPではなくResendのAPIを通じて送信され、送信のたびにResendのメッセージIDも一緒に記録されます。

配信が機能しているか確認する

KolleKは、送信したすべてのメールをユーザーごとに、件名、本文、配信ステータスとともに記録します。テスト送信の後は、次の2箇所を確認してください。

• 自分の受信箱。これは当然です。
• 受信者のプロフィール内にある送信済みメールページ。インスタンスがそのユーザーに送ったメールが一覧表示されます。自分の操作履歴と送信済みメールを参照してください。

よくある失敗の兆候:

• 何も届かず、エラーも出ない。 メーラーがまだlogのままです。.envの変更がコンテナの再作成によって反映されているか確認してください。
• メールは送信されるが迷惑メールに入る。 送信元ドメインが認証されていません。プロバイダー側でSPFとDKIMを設定してください。
• ログに送信エラーが出る。 認証情報またはホストの詳細が間違っています。queueワーカーのログに、プロバイダー側のエラーメッセージが記録されています。

メールはバックグラウンドのキューによって送信されるため、queueコンテナが稼働していなければ、インスタンスから何も送信されません。

次に読むべきもの

• KolleKが送信するメールで、インスタンスが送信するメールの種類を把握しましょう。
• メール配信のトラブルシューティングで、配信の問題を診断しましょう。