nativeInstallerfat-free-crm

Configure SMTP for outbound emails

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and Mac OS X) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). Learn more.

To configure outbound email, follow these steps:

  • Log in to the server console.
  • Edit the installdir/apps/fatfreecrm/htdocs/config/settings.yml file and update it with details for your SMTP server. For example, to configure a Gmail account, you could use the settings below. Replace USERNAME and PASSWORD with your Gmail account username and password respectively.

    smtp:
        address                    : "smtp.gmail.com"
        from                       : "email_sender"
        enable_starttls_auto       : true
        port                       : "587"
        authentication             : :plain
        user_name                  : "USERNAME@gmail.com"
        password                   : "PASSWORD"
    
  • Save your changes.

  • Restart the servers.

    $ sudo installdir/ctlscript.sh restart; (for cloud images and virtual machines)
    

To configure the application to use other third-party SMTP services for outgoing email, such as SendGrid, refer to the FAQ.

NOTE: If you are using Gmail as the outbound email server and have experienced issues trying to send emails correctly, check the Gmail SMTP troubleshooting page to learn the causes of these issues and how to solve them.

Last modification January 18, 2019