Toby Documentation

April 24, 2004

Logging In

Users at Toby's login screen are presented with a simple form to login; only their e-mail address and password for that account are necessary. The user can choose here to stay logged in even after closing the browser; this function requires that cookies be allowed.

Toby supports both IMAP and POP3 mail protocols. (If you don't know what these are, don't worry. You don't need to to use Toby.) After the user logs in, Toby begins some work on determining the user's mail server and protocol.

Toby begins by checking if a user from this domain has logged in on this server before. If they have, their host and protocol will be stored in the email_hostss database. If they have not, Toby begins to check a number of possible hosts for a correct username and password combination.

If the user entered, Toby will check all combinations of the hosts,,,,, and, the usernames my.username and, and the POP3 and IMAP protocols for a successful connection. If none of these are successful, Toby will then check again, using the name of the host at which is hosted. For example, is hosted on If Toby was not able to connect to any of the variations, it would try This type of host determination is unique to Toby, and is not found in other webmail programs.

Upon determining a user's host and protocol, it will store those values in the email_hosts and email_users databases for future reference. If Toby cannot determine the user's mail server, it will ask the user for it.

Next: Message retrieval