How to edit BMS SMTP Settings

Created by Rowena Tulod
Last updated: 03 Feb, 2017


this only applies to Forgot Password and Ask Support mailer

Step-by-step guide



  1. If clients prefer to use their own SMTP, these details must be provide
    • SMTP Host
    • Protocol
    • Port
    • Username
    • Password


    Example using YahooMail:


  2. Edit workbench.properties located here:

    C:\BMS4\infrastructure\tomcat\webapps\ibpworkbench\WEB-INF\classes

     Find the similar lines  below, replace the values with your own SMTP details

     # settings for smtp

    mail.server.host=(SMTP Host)

    mail.server.port=(Port)

    mail.server.protocol=(SMTPS or SMTP)

    mail.server.username=(username or email)

    mail.server.sender.email=(username or email)

    mail.server.password=(ThePassword)

    reset.expiry.hours=24

  3. Save the changes
  4. Restart TomCat


Most companies and service providers block ports 25 and 465 to prevent spam. Below are the possible scenarios if you are unable to receive email after requesting for password reset:

(the following requires familiarity with technical terms and server interface – when in doubt please contact your IT helpdesk or request IBP support)

  • The server where BMS is installed is not connected to the internet
  • Your Windows Firewall or personal anti-virus is blocking the connection, please allow port 465 (refer to existing Windows Firewall howto)
  • Port 465 is blocked by your service provider, please request if it can be opened
  • Use a different port number and configure BMS to follow that
  • (Brandon shared an alternate SMTP host on port 26, let me know if we can offer this as option)


For deployments without internet access, you need to setup your own SMTP server and modify workbench.properties, otherwise Forgot Password feature won’t work. Please ask assistance from your server administrator.

How to test if your outgoing port 465 is open

(free online tool)

Open Windows Powershell where BMS is installed, copy and paste the following command:

Test-NetConnection -InformationLevel detailed -ComputerName portquiz.net -Port 465


Result when port is Closed

Result when port is Open


Content by label

There is no content with the specified labels


1.      Restart TomCat