Configuring a Server-Wide Smarthost

You can configure a smarthost for the whole server. This works in Plesk for Linux with Postfix and Plesk for Windows with either MailEnable or SmarterMail.

To configure a server-wide smarthost:

1. Choose a reputable SMTP relay service (for example, SendGrid, Mailgun, Mailjet, or similar providers) and create an account there.

2. Accedi a Plesk.

3. Vai su Strumenti e impostazioni > Smarthost (in «Posta»).

4. Seleziona la casella di controllo «Invia la posta degli utenti tramite uno smarthost».

5. Nel campo corrispondente, specifica l’indirizzo IP o il nome host di uno smarthost (ad esempio, 192.0.2.1 o smtp.sendgrid.net).

   Nota

   In Plesk per Linux, puoi disabilitare le ricerche MX o SRV inserendo il nome host o l’indirizzo IP tra parentesi quadre, ad esempio [example.com]. Per maggiori dettagli, vedi la documentazione di Postfix (la sezione su relayhost).

6. Se il servizio di relay SMTP richiede l’autenticazione SMTP (come la maggior parte dei servizi), seleziona la casella di controllo «Autenticazione richiesta».

7. Se nel passaggio precedente hai selezionato «Autenticazione richiesta», specifica le credenziali per l’autenticazione al tuo servizio di relay SMTP.

   Se il servizio supporta l’autenticazione di base, specifica il nome utente e la password nei campi corrispondenti. Se il servizio supporta l’autenticazione tramite chiavi API, nel campo «Nome utente», specifica il nome utente predefinito utilizzato per le chiavi API nel servizio (ad esempio, in SendGrid, il nome utente è apikey) e, nel campo «Password», specifica il valore della chiave API.

8. (For SmarterMail only) In the «Encrypted connection» section, select whether to encrypt the credentials transmitted to the SMTP relay service. Choose if the encrypted connection is TLS, SSL, or not required.

   Nota

   If you choose a connection type that the SMTP relay service does not support (for example, SSL instead of TLS), the smarthost will refuse the connection.

9. (Facoltativo) Potresti voler controllare se la connessione allo smarthost può essere stabilita. Per farlo, clicca su Verifica connessione.

   If you selected “Encrypted connection” in the previous step, Plesk tests the connection not only for encryption but also for a valid SSL/TLS certificate. If the connection is encrypted but the SSL/TLS certificate is not trusted (for example, expired or self‑signed), the smarthost will refuse the connection.

   Nota

   Puoi modificare il comportamento predefinito descritto sopra e consentire di stabilire la connessione anche se non è protetta da un certificato SSL/TLS valido.

10. Fai clic su OK.

11. Aggiorna i record SPF e altri record DNS correlati nel modello DNS e nelle zone DNS dei domini esistenti. I servizi di relay SMTP forniscono le informazioni su quali modifiche DNS apportare.

    Hai configurato lo smarthost sul lato Plesk. Tuttavia, la maggior parte dei servizi di relay SMTP commerciali richiedono l’autenticazione del dominio sul loro lato (può anche essere chiamata «verifica del dominio»). I seguenti servizi di relay SMTP la richiedono: SendGrid, Mailjet, Mailgun.

12. Vai al tuo account del servizio SMTP relay e autentica tutti i domini ospitati in Plesk. Per i passaggi esatti su come farlo, fai riferimento alla documentazione del tuo servizio.

13. Invia un’e-mail di prova a un servizio di posta elettronica esterno (ad esempio Gmail) e assicurati che l’e-mail sia arrivata nella posta in arrivo.

Hai configurato lo smarthost sia in Plesk che nel tuo servizio relay SMTP. Il tuo smarthost è ora attivo e funzionante.

Configuring Smarthost for a Domain

You can configure a smarthost for an individual domain. This works in Plesk for Linux with Postfix and Plesk for Windows with either MailEnable or SmarterMail.

To configure a smarthost for a domain:

1. Choose a reputable SMTP relay service (for example, SendGrid, Mailgun, Mailjet, or similar providers) and create an account there.

2. Accedi a Plesk.

3. Go to Websites & Domains > [domain_name] > Mail > Smarthost.

4. Seleziona la casella di controllo «Invia la posta degli utenti tramite uno smarthost».

5. Nel campo corrispondente, specifica l’indirizzo IP o il nome host di uno smarthost (ad esempio, 192.0.2.1 o smtp.sendgrid.net).

   Nota

   In Plesk per Linux, puoi disabilitare le ricerche MX o SRV inserendo il nome host o l’indirizzo IP tra parentesi quadre, ad esempio [example.com]. Per maggiori dettagli, vedi la documentazione di Postfix (la sezione su relayhost).

6. Se il servizio di relay SMTP richiede l’autenticazione SMTP (come la maggior parte dei servizi), seleziona la casella di controllo «Autenticazione richiesta».

7. Se nel passaggio precedente hai selezionato «Autenticazione richiesta», specifica le credenziali per l’autenticazione al tuo servizio di relay SMTP.

   Se il servizio supporta l’autenticazione di base, specifica il nome utente e la password nei campi corrispondenti. Se il servizio supporta l’autenticazione tramite chiavi API, nel campo «Nome utente», specifica il nome utente predefinito utilizzato per le chiavi API nel servizio (ad esempio, in SendGrid, il nome utente è apikey) e, nel campo «Password», specifica il valore della chiave API.

8. (Facoltativo) Potresti voler controllare se la connessione allo smarthost può essere stabilita. Per farlo, clicca su Verifica connessione.

9. Fai clic su OK.

10. Update the SPF record in the DNS zone of the domain you configured. This ensures the SMTP relay service is authorized to send mail for this domain.

    Hai configurato lo smarthost sul lato Plesk. Tuttavia, la maggior parte dei servizi di relay SMTP commerciali richiedono l’autenticazione del dominio sul loro lato (può anche essere chiamata «verifica del dominio»). I seguenti servizi di relay SMTP la richiedono: SendGrid, Mailjet, Mailgun.

11. Go to your SMTP relay service account and authenticate the domain you just configured smarhost for in Plesk. For exact steps on how to do so, refer to the documentation of your service.

12. Invia un’e-mail di prova a un servizio di posta elettronica esterno (ad esempio Gmail) e assicurati che l’e-mail sia arrivata nella posta in arrivo.

Hai configurato lo smarthost sia in Plesk che nel tuo servizio relay SMTP. Il tuo smarthost è ora attivo e funzionante.

If you want to check which domains have an active smarthost, go to Mail> Smarthosts.

Configurazione di uno smarthost dopo una precedente configurazione manuale

Se hai già configurato manualmente uno smarthost, abilitare la funzionalità smarthost in Plesk sovrascriverà la configurazione esistente. Sebbene Plesk applichi la configurazione più comune adatta alla maggior parte dei servizi smarthost, potresti dover modificare la configurazione per adattarla al tuo smarthost.

Se hai già configurato manualmente uno smarthost, ti consigliamo il seguente algoritmo:

1. Confronta entrambe le configurazioni dello smarthost: quella manuale e quella di Plesk.

2. Rimuovi dalla configurazione manuale i parametri che saranno controllati da Plesk.

3. Mantieni i parametri aggiuntivi non coperti da Plesk così come sono.

4. Abilita la funzionalità smarthost in Plesk.

Per aiutarti a confrontare entrambe le configurazioni, di seguito descriveremo come funziona la funzionalità smarthost, specificando quali file di configurazione influenza e in che modo.

(Plesk per Linux) Configurazione smarthost con Postfix

When you enable the smarthost feature, Plesk performs a few actions under the hood.

For server-wide smarthost:

1. Plesk adds lines of the following pattern to the /etc/postfix/main.cf configuration file:

   # Sets an external SMTP relayhost with a port number
   relayhost - [Your-SMTP-server-IP-or-hostname]:587
   # Turns on authentication
   smtp_sasl_auth_enable = yes
   # Sets the username and password required for authentication
   smtp_sasl_password_maps = /var/spool/postfix/plesk/relay_secrets
   # Prohibits anonymous authentication methods.
   smtp_sasl_security_options = noanonymous
   

2. Plesk then checks that /etc/postfix/main.cf contains no duplicate directives, which can break the configuration:

   cat /etc/postfix/main.cf | grep -E "relayhost|smtp_sasl_auth_enable|smtp_sasl_password_maps|smtp_sasl_security_options"
   

3. Plesk configures the API authentication to the SMTP relay service of your choice via the /etc/postfix/sasl_passwd file. For example, with the SendGrid service, the following line will be added:

   [smtp.sendgrid.net]:2525 apikey:<your-SendGrid-API-key-value>
   

4. Finally, Plesk reloads the Postfix service to apply the changes:

   systemctl reload postfix
   

For a domain-specific smarthost:

1. If no server-wide smarthost has been previously configured, Plesk adds the required baseline Postfix directives to the /etc/postfix/main.cf configuration file and also adds per-domain routing and credentials (no global relayhost is needed):

   # Turns on authentication
   smtp_sasl_auth_enable = yes
   # Sets the username and password required for authentication
   smtp_sasl_password_maps = hash:/var/spool/postfix/plesk/relay_secrets.db
   # Prohibits anonymous authentication methods.
   smtp_sasl_security_options = noanonymous
   # Enables per‑sender authentication and routing
   smtp_sender_dependent_authentication = yes
   # Maps sender addresses to specific relay hosts
   sender_dependent_relayhost_maps = hash:/var/spool/postfix/plesk/sender_relay.db
   

2. Plesk then checks that /etc/postfix/main.cf contains no duplicate directives, which can break the configuration:

   cat /etc/postfix/main.cf | grep -E "smtp_sasl_auth_enable|smtp_sasl_password_maps|smtp_sasl_security_options|smtp_sender_dependent_authentication|sender_dependent_relayhost_maps"
   

3. Plesck adds or updates the sender‑dependent mapping files used for domain‑level smarthosts

   • /var/spool/postfix/plesk/sender_relay.db — maps domains to their relay hosts.

   • /var/spool/postfix/plesk/relay_secrets.db — stores credentials for the corresponding relay hosts.

   For example, with the SendGrid service, Plesk writes entries similar to:

   # sender_relay
   admin@example.com    [smtp.sendgrid.net]:587
   
   # relay_secrets
   [smtp.sendgrid.net]:587    apikey:<your-SendGrid-API-key-value>
   

4. Finally, Plesk reloads the Postfix service to apply the changes:

   systemctl reload postfix
   

(Plesk per Windows) Configurazione smarthost con MailEnable

Quando abiliti la funzionalità smarthost, Plesk applica la configurazione MailEnable mostrata nello screenshot qui sotto. Usiamo il servizio relay SMTP di SendGrid come esempio.

Il primo screenshot mostra la configurazione dell’intero server, mentre il secondo mostra la configurazione per i domini.

(Plesk per Windows) Configurazione smarthost con SmarterMail

Quando abiliti la funzionalità smarthost, Plesk applica la configurazione SmarterMail mostrata negli screenshot qui sotto. Utilizziamo il servizio relay SMTP SendGrid come esempio.

Il primo screenshot mostra la configurazione dell’intero server, mentre il secondo mostra la configurazione per i domini.

Disabilitazione della funzione smarthost

Puoi disabilitare la funzionalità smarthost nascondendola nell’interfaccia grafica di Plesk.

Per disabilitare la funzionalità smarthost:

1. Apri il file panel.ini per la modifica, situato qui:

   • (Plesk per Linux) /usr/local/psa/admin/conf/panel.ini

   • (Plesk per Windows) %plesk_dir%admin\conf\panel.ini

   Puoi modificare il file anche dall’interfaccia di Plesk, utilizzando l’estensione Panel.ini Editor.

2. To disable smarthost at the server level, add the following lines to the panel.ini file, and then save it:

   [mail]
   smarthost.server.enabled = false
   

La funzionalità smarthost non è più visualizzata in Strumenti e impostazioni.

1. To disable smarthost at the domain level, add the following lines to the panel.ini file, and then save it:

   [mail]
   smarthost.domain.enabled = false
   

The smarthost feature is no longer shown in Websites & Domains > [domain_name] > Mail.

Disabilita il controllo del certificato SSL/TLS con il pulsante Verifica connessione

By default, if the connection to a smarthost requires encryption, clicking Check Connection also verifies whether the connection uses a valid SSL/TLS certificate. If the certificate is invalid or missing, the smarthost will refuse the connection.

Se vuoi stabilire la connessione anche se un certificato SSL/TLS non è attendibile (ad esempio, scaduto o autofirmato), puoi disabilitare la verifica del certificato.

Per disabilitare la verifica di un certificato SSL/TLS associato con il pulsante Verifica connessione:

1. Apri il file panel.ini per la modifica, situato qui:

   • (Plesk per Linux) /usr/local/psa/admin/conf/panel.ini

   • (Plesk per Windows) %plesk_dir%admin\conf\panel.ini

   Puoi modificare il file anche dall’interfaccia di Plesk, utilizzando l’estensione Panel.ini Editor.

2. For disabling the check of the certificate at server level, add the following lines to the panel.ini file, and then save it:

   [mail]
   smarthost.server.checkConnection.checkCertificate = false
   

3. For disabling the check of the certificate at domain level, add the following lines to the panel.ini file, and then save it:

   [mail]
   smarthost.domain.checkConnection.checkCertificate = false
   

Ora puoi stabilire la connessione con uno smarthost non protetto da un certificato SSL/TLS valido.