The Incoming Mail Service (Dispatcho)

What is Dispatcho?

Dispatcho is a program that is always running on a server where FogBugz has been installed. Its job is to check POP3 email boxes, see if there's any mail there, and if there is, import each email message as a new case into FogBugz.

Windows
Dispatcho runs as a service, controlled from the Services control panel.

Unix or Macintosh
Dispatcho is a daemon, started by issuing the command dispatchod start or stop.

How Does Dispatcho Know What Mailboxes to Check?

They are set up in the Mailboxes screen in FogBugz, available only to administrators. This screen is used to set up the list of which mailboxes to check, how often, and what to do with any incoming email that it finds.

Windows
Information set in the Mailboxes screen is stored in the Windows registry. When the Dispatcho service wakes up periodically, it reads the registry to figure out what to do.

Unix or Macintosh
Information set in the Mailboxes screen is stored in a file called Accessories/application.data.

What if Dispatcho Is Not Running?

Email will not be imported into FogBugz; it will just accumulate in the email inbox.

How Do I Find Out If Dispatcho Is Running?

Windows
Run the Services control panel and look for something called "Fog Creek Dispatcho." In the status column, it will say "Started" if Dispatcho is running. The "Startup Type" column is either Manual or Automatic. Automatic means that when your computer reboots, Dispatcho starts automatically, which is what you want.

Unix or Macintosh
Look for a process on your system running php dispatchod.php

How Can I Install or Uninstall Dispatcho?

Windows
See Setting up Dispatcho on Windows

Unix or Macintosh
See Setting up Dispatcho on Unix or Macintosh