- \n
- Windows:\n
- \n
- Put this file in c:\\users\\<user name>\\<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
- \n
- Mac OS X:\n
- \n
- Put this file in \\users\\<user name>\\<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
\nFile:<\/strong><\/p>\n
1. Create a file in either Notepad (Windows) or TextEdit (Mac OS X)<\/p>\n
2. Name the file the following: .mail.properties\u00a0<\/strong>(notice the dot at the beginning.)<\/span><\/p>\n
3. Fill the file with the following information, which is usually given by the email client:<\/p>\n
mail.from<\/strong>=example@email.com (type your user email account)<\/span>
\nmail.smtp.host<\/strong>=smtp.servername.com\u00a0(type your email SMTP server account) <\/span>For example, gmail’s SMTP server is at smtp.gmail.com
\nmail.smtp.port<\/strong>=465 \u00a0(Always try port 465<\/strong> first, even if they specify another port such as 587.)
\nmail.smtp.user<\/strong>=example@email.com
\nIMPORTANT! Most of the time, you MUST use the full email address as the username as shown in the above example.<\/p>\nmail.smtp.password<\/strong>= \u00a0(Type your email password here.)<\/span><\/p>\n
![](\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/07\/2017-02-21_16h01_27.png\")
<\/a><\/p>\nRESOLVING PROBLEMS:<\/strong><\/p>\n
If you are having trouble and getting authentication errors, try the following.<\/p>\n
- \n
- Anytime you make changes to this file, you should save it and close your editor. Then, you MUST restart Artisan.<\/li>\n
- Confirm your settings in the file.<\/li>\n
- Make sure the file is not saved as .txt or upgrade to version 4.1.138 or later. You can see the .txt if you change the view properties in Windows to show the file extension. If on a Mac, read below.<\/li>\n
- Make sure your file is in the correct directory. Confirm the user that you are logged in as on Windows. The .mail.properties must be in this folder.<\/li>\n
- Make sure you are including your full email address as the mail.smtp.user.<\/li>\n
- Swap out the @ sign with an underscore in your mail.smtp.user setting. \u00a0(If this does not work, put it back with the @.)<\/li>\n
- Check the port number and try 587 or check with your provider. (If this does not resolve your issue, put it back to 465.)<\/li>\n
- Contact your provider for assistance or call Artisan Tech Support for assistance.<\/li>\n<\/ol>\n
\nWorking on a Mac (Ignore this if Using Windows)<\/span><\/strong><\/h3>\n
When creating this file on a Mac, things are a bit different. There are a couple of things that need to get done before creating the file on Mac OS X.<\/p>\n
1. By default, Mac does not create .TXT or raw files. Because we need a file named with the extension properties, we are not going to be able to save it unless we change the following.<\/p>\n
Open “TextEdit<\/strong>.”<\/p>\n
Go to “Preferences<\/strong>.”<\/p>\n
![\"2015-08-18_15h30_34\"](\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/07\/2015-08-18_15h30_34.png\")
<\/a><\/p>\n
\nThen, under the “New Document<\/strong>” tab, check “Plain Text<\/strong>.”<\/p>\n
![\"2015-08-18_12h51_42\"](\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/07\/2015-08-18_12h51_42.png\")
<\/a><\/p>\n
\nUnder “Open and Save<\/strong>” tab, uncheck the box “Add “.txt” extension to plain text files<\/strong>.”<\/p>\n
- Put this file in \\users\\<user name>\\<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
- Mac OS X:\n
- Put this file in c:\\users\\<user name>\\<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n