Team Password Manager uses e-mail to send password reset messages to its users (when they click on the "Forgot you password?" link on the "Sign in" screen), to notify admins when an IP address is blocked automatically and other notifications like password unlocking or expiry. It's important, then, that email works correctly. This document explains how you can configure email in Team Password Manager and gives some directions in case you have problems with it.
Team Password Manager can send email messages in two ways: the PHP mail() function and an SMTP server. You can change email configuration by clicking on the "Settings" menu and then the "Email configuration" tab.
Using the mail() function
This is the default configuration for email in Team Password Manager. If no SMTP server is configured, the PHP mail() function will be used to send email.
This way of sending email is not recommended because: 1) on some systems it may not work, and 2) some mail systems might not accept messages sent this way, resulting in lost messages and/or messages flagged as spam.
Using an SMTP server
This is the preferred method for sending email in Team Password Manager, and it's the same method your email client uses.
To configure it you must have the appropriate parameters that your SMTP server uses, that are: the host, if it uses TLS or SSL encryption and the SMTP port, user and password. You can get this parameters from your email provider or by looking for them in your email client.
If you're using Google Gmail or Microsoft Hotmail, here you have the configuration values that these services use:
SMTP Host: smtp.gmail.com
TLS/SSL Encryption: ssl
SMTP Port: 465
SMTP User: your e-mail address, like: firstname.lastname@example.org
SMTP Password: your password
SMTP Host: smtp.live.com
TLS/SSL Encryption: tls
SMTP Port: 587
SMTP User: your e-mail address, like: email@example.com
SMTP Password: your password
To set an SMTP server click on "Edit SMTP server configuration" and fill in the required fields:
* Note: if your SMTP server doesn't require authentication, you can leave blank them SMTP User and SMTP Password fields, but you should fill in the others.
Testing email configuration
To test that your installation of Team Password Manager can send emails correctly, you can use the "Send test email (to yourself)" button. This will send a test message to your email address and will tell you if the message was correctly sent or if there were some errors.
Troubleshooting email configuration
Email is sometimes tricky to configure. Here we list some of the problems you might run into and their possible solutions:
- Using the mail() function, email cannot be sent. This is probably because your server doesn't have any email server installed. In Linux you can install postfix, for example.
- Using an SMTP server, you get the following error when sending the test email: Failed to parse address "(the smtp host)". This indicates that Team Password Manager doesn't find your SMTP server, either because you didn't enter the correct name for the SMTP host and/or port, or because there's some kind of DNS problem.
- Using an SMTP server, you get the following error when sending the test email: 13 Permission denied. This means that the SMTP host has been found but somehow the client (your Team Password Manager installation in this case) can't connect to it. This may be due to several reasons:
- A firewall is blocking access to the SMTP server. It could be the firewall in the Team Password Manager server, the one in the email server or any firewall in between. You can rule this out by doing a "telnet server port" from the Team Password Manager server.
- SELinux is too restrictive. You should put SELinux in permissive mode or execute this command:
setsebool -P http_can_sendmail 1.
- The client (useragent=Team Password Manager) is not recognized by the SMTP server. In this case it would need to accept an Unknown Client.