Getting Started

First make sure you have installed the MailBoxer Zope product into your Zope instance and restarted Zope.

To create a MailBoxer instance, add a MailBoxer via the Add Menu in the ZMI of your Zope or Plone hosting account. For information on all the various configuration options you are faced with, see How can I (re-)configure a MailBoxer? (scroll down the page).

Among other things, make sure you set the very important mtahosts variable (also accessible under the Properties tab of the MailBoxer) to the IP our mailserver forwards email from:

216.10.79.225

You will also want to set the batchsize variable to 20.

Connecting your MailBoxer with the Mailserver

In order to send email to your list, you will want to connect it with our mailserver. This is a three-step process:

1. Login to Qmailadmin and create a forward. This is the email address that email for your MailBoxer will get sent to. For example, you might create the forward "mylist" at the domain "example.com", which means your list's email address is mylist@example.com. Enter 'none@example.com' as the Destination for the forward.
2. Email support with the script you want to use and the name of the forward. Please note that we already have the gateway script installed, so please do not send it to us. The script you need to send us will be in this form noted below.
3. Test, test, test. :)

The script is as follows:

http://IP:port/path/to/mailboxer/manage_mailboxer Maximum_Bytes

IP is the IP Number that your zope is running on. You get the IP by logging in via SSH to your account and running this command:

dnsip `hostname`

Port is the Port your Zope's HTTP Server is running. This is a four-digit number, usually 8080, which you can get from the Zope Control Panel via the ZMI.

/path/to/mailboxer is the path in zope to your MailBoxer instance.

manage_mailboxer is the method of MailBoxer you are using. In most cases this will be "manage_mailboxer".

Maximum_Bytes is the maximum size of email you want your MailBoxer to accept, in bytes. 51200 (50Kb) is a good starting number.

Here is an example:

http://192.168.1.4:8080/mystuff/lists/alerts/manage_mailboxer 51200

Subscribing & Posting to your List

Once everything is setup, you can send your messages to to your list email, ie mylist@example.com.

To subscribe send a message to your list email with subject subscribe.

Alternate Setup for Greater Control

If you don't mind your lists being at listname@subdomain.example.com then we can setup the Mailboxer forwards in your account space where you will have direct access to add, update and delete them. This is the way we will soon be recommending that all MailBoxers be set up.

More Information

To get even more information on MailBoxer, visit the MailBoxer website.

Questions?

Please contact us with your questions and we will get back to you right away.