The Horde User's FAQ contains questions and answers regarding using Horde and its components. If you are not the system administrator for your Horde installation, this is probably the FAQ you want. On the other hand, if you're having trouble getting IMP installed and running, you probably want the Administrator's FAQ.
Please send updates, corrections and comments to the FAQ maintainer.
Last modified: 10:49am, April 1, 2004 PST
1.1 What is...2. IMP Questions
1.1.1 Horde?1.2 How can I get help with using Horde?
1.3 Where can I find documentation?
1.4 I found a bug in Horde. Who should I tell?
1.5 While using Horde, I get an error from the web server.
2.1 How do I get an account?3. Turba Questions
2.2 IMP won't let me login.
2.3 What is my email address?
2.4 How do I change my password?
2.5 What do "new" and "recent" mean at the top of the IMP display?
2.6 What does the plus sign ("+") [IMP 2.2] or the image of face [IMP 3.0] in the message index mean?
2.7 In mailbox view, IMP occasionally shows the recipient, instead of the sender, of the message.
2.8 Why do I have to "subscribe" to folders?
2.9 How do I get rid of deleted mail?
2.10 How do I send mail to more than one person?
2.11 How can I quickly access the entries in my Contacts List?
2.12 How do I store more than one email address in a Contacts List entry?
2.13 How do I attach a file to a message I've composed?
2.14 How can I view a message's full headers?
2.15 How can I filter, forward, block, or automatically respond to mail?
2.16 After using IMP, my non-Web mail program shows a message with the subject, "DON'T DELETE THIS MESSAGE -- FOLDER INTERNAL DATA".
2.17 After spellcheck, how do I find out the correct spelling of misspelt words?
2.18 How can I request a return receipt or delivery notification?
2.19 How can I have IMP notify me when new messages arrive?
2.20 Can I undelete messages?
2.21 How do I print the content of an email message?
3.1 How do I store more than one email address in a single address book entry?4. Kronolith Questions
3.2 How do I list all the entries in my address book?
3.3 Why don't I see the address book icon after header email addresses in IMP?
3.4 Can Turba use shared address books?
3.5 How can I delete all my contacts and start over?
4.1 Does kronolith have "shared" calendar support?5. Miscellaneous
4.2 Can kronolith sync with my Palm Pilot?
4.3 How do "alarms" work?
4.4 Does Kronolith support iCalendar invitations?
5.1 Who maintains this FAQ?
5.2 Can I maintain a local copy of this FAQ?
5.3 Where can I find this FAQ?
1.1.1 What is Horde?Horde [http://www.horde.org] is both a piece of software and a project. The Horde Project comprises a set of Web-based productivity, messaging, and project-management applications, each of which is described below. The Horde Framework is a common code-base used by Horde applications, including libraries and a common user interface.
The Horde Framework doesn't do anything on its own; as a user, you will always be interacting with a Horde-based application.
1.1.2 What is IMP?IMP [http://www.horde.org/imp/] is the Internet Messaging Program (formerly, among other things, the IMAP webMail Program), a webmail system and a component of the Horde project. IMP is the most widely-deployed component of Horde.
IMP offers most of the features users have come to expect from their conventional mail programs, including attachments, spell-check, address books, multiple folders, and multiple-language support.
1.1.3 What is Turba?Turba [http://www.horde.org/turba/] is the Horde Address book and Contact Management application. It grew out of the need for a more complete address book than the one built in to older versions of IMP. It provides a generic frontend to searching LDAP, SQL, and other contact sources.
1.1.4 What is Kronolith?Kronolith [http://www.horde.org/kronolith/] is a web-based calendar and daily organizer (think Day-Timer). It currently provides a robust web-based calendar for individual users with repeating events, and a smart algorithm to display a whole day of events even if many of them overlap with each other. Future plans include support for shared calendars, merging multiple calendars into a single view, and Palm syncing.
1.1.5 What is Nag?Nag [http://www.horde.org/nag/] is a simple, multiuser task list manager.
1.1.6 What is Mnemo?Mnemo [http://www.horde.org/mnemo/] is a simple note manager (meno pad application).
The best place to turn for assistance with Horde applications is the support staff at the Internet service provider, school, company, or other organization whose webmail service you are using. Many commonly-encountered problems involve local matters with which Horde developers cannot assist you.
If you are not able to obtain assistance from your local support staff, you may wish to try asking the mailing list [http://www.horde.org/mail/] for the component you're using. Make sure you describe the problem clearly, including all error messages you might have received. Remember to report the version number of the application (if you know it), as well as what browser and OS you are using to access it.
Please don't contact the developers or the FAQ maintainer directly. They usually don't have time to deal with individual installations of Horde and its components, being too busy developing and FAQ-maintaining. (Besides, they're probably on the mailing list anyhow.)
Unfortunately, the documentation for Horde applications often lags behind the application itself, and much of the current versions of Horde applications remain undocumented. Speak with your local support staff to see if local documentation has been made available.
If you would like to volunteer to write a user's manual for a component of Horde, please let us know on the docs mailing list [http://www.horde.org/mail/]!
Before you do anything, take a moment to read this article on bug reporting [http://www.chiark.greenend.org.uk/~sgtatham/bugs.html], and keep its comments in mind when reporting Horde bugs.
Having read that, there are two places where a bug can be reported. If you're on the mailing list [http://www.horde.org/mail/] for the component you think you've found a bug in, send a message to the mailing list, and be sure to keep an eye out for replies. You can also enter the bug into the Horde bug database [http://bugs.horde.org].
Be sure to describe exactly how to reproduce the bug (if you know!), and include all error messages that appeared. Also, please inform your local support staff of the bug; they will be able to provide us with information specific to your organization's configuration which may be necessary in resolving the problem.
If, while using a Horde application, error messages appear in your browser, inform your support staff of the problem, being sure to note the exact error message, what you were doing when it occurred, and the time and date of the occurrence. Should they not be able to resolve the problem, they can follow the bug-reporting directions found in the Horde Administrator's FAQ [http://www.horde.org/faq/admin/].[Return to Table of Contents]
To get an account on a particular organization's IMP system, you will need to contact the support staff at the organization. IMP's developers have no connections with the organizations that use IMP.
If you wish to try IMP without doing so through a particular organization's system, there is a demo site [http://www.horde.org/demo/]available which will allow you to access your existing mail account over IMAP or POP3. The demo site is unsupported and comes with no guarantee or promise of continued availability.
If you are unable to login to IMP, contact your organization's support staff. They are the only ones who can manage accounts within your organization; IMP's developers cannot.
To risk sounding repetitive, contact your organization's support staff for all information regarding your local mail system. You can also send mail to a friend requesting that they reply, and observe the address to which their reply was sent.
[IMP 2.2] If your organization's installation of IMP supports password changes over the Web, you will see a Change Password link in IMP's menu. Click on that link in order to change your mail password. If that link does not appear in the menu, your support staff will be able to inform you of password-change procedure at your site.
[IMP 3.x] If your organization's installation of Horde and/or IMP supports password changes over the Web, you will see a Password link in Horde's and/or IMP's menu bar. Click on that link in order to change your mail password. If that link does not appear in the menu, your support staff will be able to inform you of password-change procedure at your site.
[IMP 2.2] In IMP's status bar, above the mailbox index or message body part of the display, "new" refers to messages which have not been read since they arrived, while "recent" refers to messages that have arrived since the last time you looked at the mailbox's index.
A plus sign ("+") [IMP 2.2] or image of a face [IMP 3.x] in the left-hand column of an entry in the mailbox index view means that that message was sent directly to you, and not only Cc'd to you or sent via a mailing list. In other words, your address appears in the To: header.
IMP's mailbox view shows the recipient in the From column on messages for which you are the sender. (In other words, since you sent it, you know who the sender is, so IMP tells you who you sent it to.) This is particularly useful for the sent-mail and drafts folders.
Depending on the way your site has configured IMP, you may be presented, when you click on the Folders link in IMP's menu, with a list of mailboxes to which you can subscribe (and unsubscribe). Since it is possible to have a very large number of mail folders in your account but not actively use all of the folders -- the others, for instance, being archives of old mail -- IMP allows you to specify which folders you wish to be able to access in IMP. Subscribing to a folder makes it appear in the lists of folders to which you can copy, move, and save messages and for which you can display a message index.
If your site's IMP configuration allows you to use multiple folders but does not require you to subscribe to the ones you wish to access, you will always see all of your folders in IMP's folder lists.
[IMP 2.2] When you tell IMP to delete one one or more messages (by clicking Delete in the message view, or by selecting the check box to the left of the message in the mailbox index view and then clicking Delete), the mail is only marked as deleted, and is not immediately removed from your mailbox, giving you the opportunity to decide to undelete it. If you are certain you will not need the deleted message(s), click on Purge Deleted (or, in older versions, Expunge) in the mailbox index view. If you only wish to make IMP stop displaying the deleted messages, without permanently removing them, click Hide Deleted from the mailbox index view.
[IMP 3.x] IMP 3.x can work in two modes: marking mail as deleted, and moving deleted messages to a Trash folder. In the first mode, it works the same as IMP 2.2 as described in the above paragraph.
If you are using the Trash folder feature, it acts somewhat differently. When you tell IMP to delete one or more messages (by clicking Delete in the message view, or by selecting the check box to the left of the message in the mailbox index view and then clicking Delete), the mail is moved to a Trash folder, giving you the opportunity to decide to undelete it (remove it from the trash) later. If you are certain you will not need the deleted message(s), click on Empty Trash folder in the mailbox index view. In addition, you can have IMP schedule to automatically empty your trash folder at various intervals via the "Maintainence Operations" section of Options.
To send mail to more than one person, separate their email addresses in the To:, Cc:, or Bcc: header (or a combination of all three) with commas (","). Do not use semicolons (";") to separate lists of email addresses.
[IMP 2.2] Instead of opening the Contacts List dialog, you can save time when sending mail to people in your Contacts List by typing their nickname in the appropriate header field in the Compose window itself.
[IMP 3.0] Instead of opening the Address book window, you can save time when sending mail to people in your Address book by typing their name, or part of their name, in the appropriate header field in the Compose window itself and the using the Compose window's Expand Names button to expand the name to the full address. If multiple Address book entries match, you will be given a selection list of all the matching entries from which you may select the desired address.
[IMP 3.1] In addition the the Expand Names button discussed above in IMP 3.0, IMP 3.1 has an Address Book button which can be used to look up names in the Turba Address Books (if available).
[IMP 2.2] Each Contacts List entry can only contain a single email address.
[IMP 3.x] Full support for multiple addresses is still being implemented. But, in most cases you can store multiple addresses in a single Address book entry simply by listing all the email addresses in the Address book Email field separated by commas. Do not use semicolons (";") to separate lists of email addresses.
Note that the number of addresses that fit in a single entry may be limited.
Due to the nature of Web-based mail, attaching a file to a message you are about to send is slightly different than what you may be accustomed to in conventional mail programs. Attaching a file requires two steps. While composing the message:
Please note that for large files and/or slower Internet connections, the process of uploading and attaching your file to the email may take a while. Please be patient and do not click on other things while you are waiting.
- Type the filename in the Attachment field, or press the Browse button to use a dialog box to choose the file to attach.
- Press the Attach button to attach the selected file. This may take a moment as the file is copied from your computer to the server on which you access IMP.
To see the entire message header, click the Message Source link in the Parts section of the message view. This will show you the raw mail message in the mailbox, including full headers and any attachments in encoded form.
[IMP 2.2] All of the above functions should be done when mail arrives in the mailbox, not via IMP. Speak with your organization's support staff to see what facilities are available.
[IMP 3.x] All of the above functions are best done when mail arrives in the mailbox, not via IMP. Speak with your organization's support staff to see what facilities are available for this. However, limited support for filtering and blocking of messages within IMP is supported.
If you want to filter future messages from the same person as the message you are currently using, use the Blacklist link when in the message view. This will add a rule to filter out that sender, and take you to the Filter Rules Options page.
For more general filtering, select the Options menu item in IMP, and then select Filters from the Mail Management section.
Note that creating a rule does not filter any messages! You must click the Apply All Rules button on the Filter Rules page or the "Apply Filters" icon next to the INBOX name in the mailbox view to filter all undeleted messages according to the specified rules. If your installation has persistent options, you can set up filter options to apply your filter rules at login and/or when the a mailbox is refreshed.
You can also create, remove, or arrange the order of rules from the Filters Rules page. Note that rules are applied once per message, hence rule order is significant. Make sure you have the most important rules first.
There are also modules in CVS to interface with SpamAssassin ( sam), set up vacation notices ( vacation), and set up automatic forwarding ( forwards).
There is also a configuration item in the cvs HEAD version of IMP that allows one to report spammers to a local spamassassin installation additionally or instead of the IMP blacklist.
This is an artifact of the IMAP server that your organization uses, from which IMP retrieves your messages. The message can be ignored.
[IMP 2.2] IMP 2.2 does not suggest replacements for misspelt words; it only identifies words which do not appear in its dictionary.
[IMP 3.x] IMP 3.x will suggest replacements for misspelt words automatically.
[IMP 2.2] IMP 2.2 (and much of the Internet) supports neither return receipts nor delivery notification.
[IMP 3.x] IMP 3.x does have support for return receipts. You can request a return receipt by clicking the "Request a Return Receipt" checkbox in the message composition screen.
Whether or not you will get a confirmation back depends on many factors outside of IMP's control. For example, some mail servers will remove return receipt requests from mail before it reaches the recipient, and some mail clients will allow the user to select if return receipts should be honored. Because of these and other factors, you should not depend on return receipts being honored by all recipients.
[IMP 3.x] If you IMP installation supports persistent preferences, you can configure this via the Options link in the IMP menu bar. From Options select New Mail (from the "Other Options" area), then check the checkbox labeled "Display pop-up notification of new mail."
[IMP 3.x] You can undelete messages any time up until you click on the Empty Trash or Purge Deleted buttons, or until any automated emptying of the trash occurs if you have set up such an option. To undelete messages (marked as deleted) from the inbox listing, check the checkbox to the left of the messages you wish to keep, then press the Undelete link at the top or bottom left of the page. When you are viewing a message marked for deletion, there will be a link at the start and end of the message to undelete that message.
If you are using a Trash folder, you can undelete the messages by moving them out of the Trash folder into another folder.
[IMP 2.x] In IMP 2.x there is no seperate print option. You will have to use the print option of your web browser.[Return to Table of Contents]
[IMP 3.x] When viewing a message, you can easily print the contents of the message using the Print link in the menu bar that appears above and below the message. You should print the message this way rather than using the browser print function, as the browser's print function will print the entire web page rather than just the message contents.
When you click the Prink link, the message will open in a new window so you may print it. Depending on the web browser and operating system you use, your browser's print dialog box may automatically open for you. If it does not, pull down the browser's File menu and choose Print.
[Turba 1.2] To store multiple addresses in a single address book entry you must create a "list". You start by creating single entries for each address you want in the list, just as you normally would do for any other entry. Then, from the browse view, list those entries and click the checkbox to the left to each name you want in your list. Next, select New List from the slection box in the upper right corner of the browser window, and click the Add to button. You will be presented with a window asking for the name of the distribution list to create. Type the list name, and click on the OK button, and you list should be created.
To add addresses to an existing list, preceed as above but select the existing list new instead of New List from the list selection box.
Note that the number of addresses that will fit in a single entry may be limited by your installation.
[Turba 1.1] While it is sometimes possible to fake some limited list support in Turba 1.0 or 1.1, this procedure may cause problems and therefore it is recommended that you upgrade to Turba 1.2 to get proper list support instead.
[Turba 1.2] Click one the Turba Browse icon in the top menu bar. Then select the address book you want to browse, and click on the Show button. In some large address books, the number of entries returned may be limited.
[Turba 1.1] Go to the Turba search window. Select "Name" in the "Find" field. Leave the "Matching" field empty. Select "My Address book" in the "From" filed. Press the Search button. You should see all the entries in your address book listed.
You probably have not selected your default address book in IMP. In IMP, use the Options button to access your preference. Select Address books, then select your address book under Choose the address book to use when adding addresses.
While there is no native shared address book functionality in Turba, Turba does support external ldap address books, which can be shared.
Many times people want to delete all their contacts, or a large number of contacts, in one simple operation. At this time, there is no way for the user to do this in Turba. You must delete them one by one.[Return to Table of Contents]
If you have a large number of contacts you want to remove (from a bad import for example), you may want to contact your system administrator and ask if they can delete them for you at the backend level (sql, ldap, etc). Many times the administrator can quickly and easily remove all entries for a user at this level. However, not all administrators can, or will, provide this level of service.
In the next release of Turba you should be able to easily delete multiple contacts easily.
At this time, the production release does not yet have shared calendar support. Preliminary shared calendar support is in the CVS HEAD version, and being actively developed.
No, not at this time. Palm syncing is planned for a future version, but there is no timeline for its implementation.
Currently alarms simply display a message when kronolith is refreshed. Other options are being considered, such as e-mail based alarms.
[Return to Table of Contents]
The released version of kronolith does not yet support iCalendar invitations.
The CVS HEAD version does support iCalendar/vCalendar format importing and exporting and the sending of iCalendar invitations for e-mail based scheduling. As such it is now interoperable with any calendar/email system which can either send or receive standard iCalendar attachments.
This means that you can create a kronolith event, send invitations for that event to any email addresses desired, and the email recipients can then add the event to their calendars automatically.
The current maintainer is Eric Rostetter, assisted by the rest of the Horde developers and users.
Well, there's nothing stopping you from doing so. We'd much prefer that you'd link to the master copy [http://www.horde.org/faq/] instead; that way, you're always sure to have the most recent version.
If you do want to mirror it, give the FAQ maintainer a shout so you can get the PHP source, rather than just the resulting HTML.
The canonical location for the FAQ is[Return to Table of Contents]<http://www.horde.org/faq/>