Commit 1f5aa719 authored by UltimateByte's avatar UltimateByte Committed by GitHub
Browse files

Added some documentation for public release

parent 37dbf692
# plesk_mail_autoconfig
Deploys Plesk autoconfig functionnality
Deploys Plesk autoconfig functionnality for:
Note: This relies on the default Plesk directory and is of course Linux only.
## Support for
- Thunderbird autoconfig
- Outlook autodiscover
- Apples iOS config generator
......@@ -29,3 +26,28 @@ nano plesk_mail_autoconfig.sh
./plesk_mail_autoconfig.sh
````
## Requirements
- Your Plesk default domain must be set to "None" (default).
- This script assumes that your machine hostname is the one to connect to for mail, and that it has SSL/TLS certificates (best practice).
- Your DNS zones shall preferably be managed into Plesk, otherwise, for Thunderbird autoconfig to work, you just need to add the following CNAME to your domain names' DNS zones: autoconfig > [hostname].tld.
- HTTPS access is required for Outlook (with a signed certificate for each domain).
## What this script does
- Creates a "mail/" directory into your default Plesk hosting page.
- Adds /ios, /autodiscover and /Autodiscover aliases that point to the mail/ dir, for iOS and Outlook.
- Accordingly to the configuration, adds the required .xml configuration files into mail/.
- Adds a CNAME to all your domains for Thunderbird autoconfig : autoconfig > [hostname].tld. (If your DNS zone is not managed into Plesk, make sure to add this entry into it.) This domain must not actually exist in your Plesk, in order to be redirected to the default hosting.
- Changes the default DNS zone to add the autoconfig cname.
## Limitations
- Android doesn't seem to have any kind of mail autoconfiguration at the moment.
- The "Mail" program form Mac OSX doesn't seem to have any kind of mail autoconfiguration at the moment.
- You shall not use /ios or /autodiscover for your websites, because they are reserved for mail configuraiton.
### Notes
If you need different settings for emails (ports, protocols, etc.), feel free to fork this, and change the repo (gituser, gitrepo, and gitbranch) to yours.
# Credits
From the Company HaiSoft https://www.haisoft.fr/
Benoît Ouacham: https://benoua.fr/
Robin Labadie: https://www.lrob.fr/
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment