Résumé: Plesk offers a handy page to help users connect their mailboxes to the mail client software of their choice. The provided instructions cover many popular mail clients, such as Thunderbird, Outlook, and Apple Mail.

If there is a need to provide alternative instructions, the content of the page can be changed.

In this topic, you will learn how to customize the « Mail Client Setup » page in Plesk.

Vue d’ensemble

The instructions on the « Mail Client Setup » page cover a number of popular mail clients, and also advise how to use autodiscover. However, if there is a need to add specific instructions particular to your installation, add links to your own help resources, and so on, the content of the page can be customized by creating and editing a copy of a template file.

Challenges and Limitations

Customizing the « Mail Client Setup » page comes with the following challenges and limitations:

  • Customizing the content of the page requires the use of the Markdown markup language. There is no WYSIWIG editor in Plesk for editing the page.
  • It also removes the tabs found on the page by default. There is no ability to add tabs to the page using Markdown.

Customizing the Page

To customize the « Mail Client Setup » page:

  1. Connectez-vous au serveur Plesk via SSH ou RDP.

  2. Run the following command to create a copy of the template file:

    • (Plesk for Linux) cp /usr/local/psa/admin/conf/email_client_configuration_instructions.md{.sample,}
    • (Plesk for Windows) cd "%plesk_dir%\admin\conf" && copy email_client_configuration_instructions.md.sample email_client_configuration_instructions.md

    This will create the email_client_configuration_instructions.md file you will need to edit. Editing the template file (email_client_configuration_instructions.md.sample) will not result in any changes.

  3. Edit the created email_client_configuration_instructions.md file using the text editor of your choice. Make sure to follow the Markdown syntax.

Once you have created the email_client_configuration_instructions.md file, the default « Mail Client Setup » page will be replaced by the placeholder page defined by the content of the file. Changes you make to the file will take effect immediately.

To revert to the default « Mail Client Setup » page, rename or remove the email_client_configuration_instructions.md file.