- 1 Email and Redmine
Email and Redmine¶
Redmine is setup to have email functionality with regards to the issue system. This means sending out emails on new issue creation, updates to issue status, fields, comments, etc., creating new issues via email, responding to issues via email. To make each of these work, requires certain configuration settings for your user in Redmine, as well as particular fields in the email messages you send. Read on for details about how to do these properly. Improper settings, or fields in the emails will result in the email being dropped on the floor, you will not receive a bounce or any information about what you did incorrectly.
You have two possibilities for email receiving:
New issue creation / issue updates¶
If you have an email address configured in your Redmine settings and have clicked the box next to the project that you wish to receive Email notifications for, you will get emails for new issue(s) and updates on existing issues. This is a good way to keep on top of issues as they come in as well as any updates to issues (including severity changes, additional notes, assignments to individual developers, etc.).
Watching specific issues¶
If you are only interested in getting email updates on specific issues, then make sure that you have a proper email address configured in your Redmine settings and that the correct settings are set there for “Email Notifications”. Then you simply have to click the watch link in the upper page header of the particular issue you wish to stay updated on.
You have two possibilities for sending emails into the system:
Creating a new issue¶
In order to create a new issue in the system, you must first have your email address configured for your account, and your From: address that appears in the email that you send, must match the email address you have configured. If your From: address contains any difference from your account settings, Redmine will refuse to do anything with your email. Please verify that your email address matches in your Redmine settings.
Once you have your email address setup properly, you can create a new issue by sending an email to firstname.lastname@example.org, you must include the Project: keyword in the body of the email, or Redmine will not know what project to create your new issue in, and instead just ignore your message. NB: the Project keyword must be capitalized.
For example, to create a new issue in the crabgrass issue tracker, sending an email (from an email address that matches your Redmine account settings) to email@example.com like so will create a new issue in the crabgrass tracker:
Subject: creating a new issue via email Project: crabgrass this is the body of the message!
Replying to issues¶
You can reply to issues that you have received already by simply hitting reply in your mail client, ensuring that your reply will be either sent To: or CC: firstname.lastname@example.org and the Subject: must include the Subject: line elements that were originally in the message that was sent to you. That means the Subject: must look like:
Re: [Monkeysphere - Bug #1054]
This will enable Redmine to determine that the project it should work with is “Monkeysphere” and the issue number it should operate on is #1054. If you do not include this information, a new issue will be created.
If your reply is not being received by the system, check your From: address, and make sure it matches the address configured in your Redmine settings
There are other keywords that you can provide in your email message to modify specific issue settings. The keywords are associated with the issue settings that you might set on an issue, for example:
project: <project identifier> priority: <priority> status: <status>
as of redmine 1.0.1 no significant changes, 27 oct 2010
the “from” part of the email-to-ticket is significant, and also a pita.