Work at SourceForge, help us to make it a better place! We have an immediate need for a Support Technician in our San Francisco or Denver office.

Close

Mailing Lists

Note: We are working on updating our documentation, this page has been identified as still needing improvement. This notice will be removed once these improvements are complete.

Mailing Lists

SourceForge.net provides mailing list services to all projects on an opt-in basis. Mailing lists are popular for:

  • Communication within a development team.
  • Communication between users and developers.
  • Release announcements.
  • Notifications of projects events like source code commits and Tracker ticket changes.

Features

  • Our mailing list services are based on GNU Mailman 2.1, with the standard feature set.
  • An email address is needed in order to subscribe to a mailing list. No SourceForge.net user account is needed, though registered site users can subscribe their mail alias to a mailing list.
  • List subscription and posting may be limited by project administrators.
  • List subscriptions are provided after a three-way handshake where users request a subscription, our system replies with a unique token, and the user confirms their request to subscribe.
  • Project administrators may create lists, configure mailing list settings, and change mailing list admin passwords using our self-service management interfaces.
  • Spam and virus control for inbound list mail prevents spread of viruses and reduces subscriber annoyance.
  • All lists are archived with our mailing list archiver, which:
    • Provides a web-based view of mailing list posts by date and thread.
    • Permits search of mailing list posts.
    • Permits the exclusion of posts that the project admin wants to hide.
  • Mailing lists are not restricted by disk quotas.
  • Project administrators are provided access to mbox archive files for their lists, to permit backups.

Sending mail to a list

Before posting to a mailing list, please note that your email will generally be publicly viewable. Mailing list subscribers may receive a copy of your message by email. Your post may appear publicly in the web-based mailing list archives.

To send mail to a list, address your email to: LISTNAME@lists.sourceforge.net

Some lists require moderator approval, or list subscription, for the post to be transmitted to list.

Subscription management

Subscribe

To initiate the subscription process, go to:

https://lists.sourceforge.net/lists/listinfo/LISTNAME

Preferences

Subscribers may manage their preferences as per Mailman documentation by logging in at the bottom of the page at:

https://lists.sourceforge.net/lists/listinfo/LISTNAME

Unsubscribe

To unsubscribe from a mailing list:

  • Go the the URL (or follow the link) provided at the very bottom of any message from the mailing list. This link will have the format: https://lists.sourceforge.net/lists/listinfo/LISTNAME where LISTNAME is the name of the list you are subscribed to, such as sample-users.
  • Scroll down to the "LISTNAME Subscribers" section of the page.
  • Enter your email address in the "To change your subscription (set options like digest and delivery modes, get a reminder of your password, or unsubscribe from LISTNAME), enter your subscription email address" field, which is the last text box on the page.
  • Click on the "Edit Options" button.
  • If you don't remember your password for the mailing list (this may or may not be the same as your SourceForge.net user account password), you should click on the "Email My Password To Me" button. You will be able to proceed once the password email has been received.
  • Type your password into the "Password" field in the "Unsubscribing from LISTNAME" section of the page.
  • Click on the "Unsubscribe" button.

List Management

Mailing lists are created and managed from the project admin interface. Additional list-specific options such as list posting policy, moderation queue access, and list member management are accessed by using the list-specific interface. Project admins who are managing lists lists will find the GNU Mailman List Administration Manual and List Administrator Tasks FAQ very helpful.

To access the SourceForge.net list management interface page perform the following steps:

  • Login to SourceForge.net as a project administrator
  • Go to Admin -> Tools
  • In the "Click to install" section, select "Mailing lists" (this only needs to be done the first time
  • Under the new Mailing List card that appears, select "Admin Mailing Lists"

The following operations are possible from this management interface:

Create a list

Under the Manage Mailing Lists section, fill out with a name and submit the form to create your list
Note that mailing list names are prefixed with the UNIX name of your project
The list software will mail you your list administration password once the list is created

Update list Visibility (mark private/public) settings

Select the drop down menu under the Visibility column for the list you wish to update
Choose the options you would like and hit "update."

Update list description

For the list you wish to change, enter a new description in the field and hit update

Reset list admin password

Select the Change Password link under the list you wish to update
Enter the new password and hit update

Access list-specific options (posting options, moderation queue, subscriber management, etc...)

Select the Mailman Admin link under the list you wish to update

Making an announcements-only list

  • Use the Mailman Admin link as directed above to access the administrative interface for the list, this will land you at the "General Options" list administration page
  • Enter the address of those who should be allowed to post in the owner or moderator text boxes. Owners have more control over the list and will get more administrative mail, moderators are only allowed to post and manipulate held postings to the list.
  • Set the option Emergency moderation of all list traffic. to Yes
  • Push the Submit Your Changes button at the bottom of the page
  • Select Privacy Options... -> Sender Filters from the Configuration Categories column at the top of the page to go to the "Privacy Options..." page
  • Set the option By default, should new list member postings be moderated? to Yes
  • Set the option Action to take when a moderated member posts to the list. to Hold
  • Set the option Action to take for postings from non-members for which no explicit action is defined. to Reject
  • Push the Submit Your Changes button at the bottom of the page

Filtering Spam from your list

SourceForge.net tags mail with a specific header indicating if the system thought it was spam or not. This header can be used in list configurations to lower the quantity of spam that makes it to your list.

  • Use the Mailman Admin link as directed above to access the administrative interface for the list, this will land you at the "General Options" list administration page
  • Select the Privacy Options... from the Configuration Categories column at the top of the page to go to the "Privacy Options..." page
  • Select the Spam Filters link located under Privacy Options...
  • Enter the following into the Spam Filter Rule 1 text box. If you already have a spam filter setup, you will need to click the Add New Item... button under the text box to add an additional rule:

    ^X-VA-Spam-Flag: YES$
    
  • Select action you would like to perform for messages with this header present. Is is strongly suggested that you initially choose Hold for this action so that you may test the filter for a while before making its operations permanent with an action such as Reject or Discard.

  • Click Submit your Changes at the bottom of the page and your filter will be in place.

Related

Documentation: Mailing List Archives