## 概要 プリザンターのリマインダーや通知機能でメールを送信するために、SMTPサーバを使ったメール送信の設定方法を説明します。 ## 注意事項 1. <span style="color:red; font-weight:bold;">バージョン1.5.5.0以降、Providerパラメータの追加に伴い設定方式が変更されています。既存環境からの移行については[メール送信プロバイダー設定の移行について](/ja/manual/mail-provider-migration)を参照してください。</span> 1. パラメータ変更時は[パラメータ変更時の確認事項](/ja/manual/parameter-edit)をご確認ください。 1. セキュリティ上の理由から、SmtpUserNameおよびSmtpPasswordはMail.jsonに直接記述せず、環境変数で設定することを推奨します。詳細は「操作手順2.環境変数による設定（任意）」を参照してください。 1. Mail.jsonの設定変更後はプリザンターの再起動が必要です。再起動を行うまで変更は反映されません。 ## 前提条件 1. 利用するSMTPサーバのホスト名・ポート番号・認証情報（ユーザ名・パスワード）を用意してください。 ## 操作手順 ### 1. Mail.jsonの設定 設定ファイル[Mail.json](/ja/manual/mail.json)を編集し、Providerに"Smtp"を指定してください。 ```json { "Provider": "Smtp", "SmtpHost": "smtp.example.com", "SmtpPort": 587, "SmtpUserName": "user@example.com", "SmtpPassword": "password", "SmtpEnableSsl": true, "FixedFrom": "noreply@example.com", "SupportFrom": "support@example.com" } ``` #### 設定項目の説明 | パラメータ | 設定例 | 説明 | | :------------ | :-------------------- | :------------------------------------------------------------------------------------------ | | Provider | "Smtp" | SMTPを使用する場合はSmtpを指定します。 | | SmtpHost | "smtp.example.com" | SMTPサーバのアドレスを指定します。 | | SmtpPort | 587 | SMTPサーバのポート番号を指定します。 | | SmtpUserName | "user@example.com" | SMTP-AUTHのユーザ名を指定します。環境変数へ登録するには、空（""）またはnullを指定してください。 | | SmtpPassword | "password" | SMTP-AUTHのパスワードを指定します。環境変数へ登録するには、空（""）またはnullを指定してください。 | | SmtpEnableSsl | true | SSL/TLSを有効化する場合はtrueを指定します。 | | FixedFrom | "noreply@example.com" | メール送信時のfromアドレスを指定します。 | | SupportFrom | "support@example.com" | サポート用メールアドレスを指定します。 | 各パラメータの詳細については[Mail.json](/ja/manual/mail.json)を参照してください。 ### 2.環境変数による設定 SmtpUserNameおよびSmtpPasswordは[Mail.json](/ja/manual/mail.json)の代わりに環境変数へ登録できます。[Mail.json](/ja/manual/mail.json)で値を指定している場合は、そちらが優先されます。 プリザンターは[Mail.json](/ja/manual/mail.json)の値が空（""）またはnullの場合にのみ、環境変数から取得します。 #### 対応する環境変数 | 対象パラメータ | 環境変数名（EnvironmentName形式） | 環境変数名（ServiceName形式） | | :------------- | :---------------------------------- | :------------------------------ | | SmtpUserName | {EnvironmentName}_Mail_SmtpUserName | {ServiceName}_Mail_SmtpUserName | | SmtpPassword | {EnvironmentName}_Mail_SmtpPassword | {ServiceName}_Mail_SmtpPassword | {EnvironmentName}と{ServiceName}は[Service.json](/ja/manual/service-json)のパラメータEnvironmentName、ServiceNameの各設定値に対応します。デフォルトのServiceNameはPleasanterです。 #### PowerShell（Windows）での設定方法 ```ps1 $env:Pleasanter_Mail_SmtpUserName = "user@example.com" $env:Pleasanter_Mail_SmtpPassword = "password" ``` #### bash（LinuxまたはmacOS）での設定方法 ```bash export Pleasanter_Mail_SmtpUserName="user@example.com" export Pleasanter_Mail_SmtpPassword="password" ``` ### 3. プリザンターの再起動 設定変更を反映するため、プリザンターを再起動してください。 Windows環境の場合は、IISを再起動してください。 Linux環境の場合は、以下のコマンドでサービスを再起動してください。 ```bash sudo systemctl restart pleasanter ``` Microsoft Azure環境の場合は、App Serviceを再起動してください。 ## 対応バージョン | 対応バージョン | 内容 | | :------------- | :----------------------- | | 1.5.5.0以降 | Providerパラメータを追加 | ## 関連情報 <div id="ManualList"><ul><li><a href="/ja/manual/parameter-edit">パラメータ設定：パラメータ変更時の確認事項</a><span>2025/12/24 up</span></li> <li><a href="/ja/manual/mail.json">パラメータ設定：Mail.json</a><span>2026/06/09 up</span></li> <li><a href="/ja/manual/service-json">パラメータ設定：Service.json</a><span>2026/06/09 up</span></li></ul></article> <ul><li><a href="/ja/manual/mail-provider-migration">メール送信プロバイダー設定の移行について</a><span>2026/06/09 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />