One thing everybody wants when deploying applications is integrating them with other applications or services. Two popular apps and services out there for small businesses that manage project management and email are Redmine and SendGrid.
- A working Redmine install.
- A sendgrid email address. Let’s say we have something like firstname.lastname@example.org that we want Redmine to send emails from.
- Here are a few gems I put on sporatically when researching email integration, so make sure you have them. Jump to where your redmine install is located (e.g. /var/www/redmine) and do the following:
The core of this funcionality is provided by the sendgrid gem which originates from here: https://github.com/stephenb/sendgrid.
Redmine Configuration File
If your Redmine install is something like /var/www/redmine, your configuration file will be /var/www/redmine/config/configuration.yml. If you have a relatively clean Redmine install, chances are you might not have one or it’s a default template with a lot of examples. You might find an example detailing how to integrate with GMail in the example file. Our set up will be similar. Paste the following into your configuration.yml file and change the necessary parameters.
1 2 3 4 5 6 7 8 9 10 11
Now if you already had a configuration.yml file for the install you jumped into, there are overrides which show up as a blank section at the end which will prevent this integration from working. It might look like:
Remove empty sections like this. You can edit things towards the beginning of your config file all day long and these blank sections will override your settings.
Through your web browser, go to Administration -> Settings, and click the “Email Notifications” Tab.
- Set the emission email address field to: email@example.com (the sendgrid account you created).
- Fix your footer URL to match your domain so users can go directly to their account settings.
- Test your settings by clicking the link “Send a test email” in the lower right hand corner.
If you are getting auth errors, make sure you are just using your user_name parameter in the configuration.yml file (i.e. just “redmine”).
If you think you can’t reach the service, try this quick connection test:
If successful, you’ll see some response like this:
1 2 3 4 5