Setting up the Person document for an IMAP user

To access mail files on the Domino® server, an IMAP user must have a Person document in the Domino® Directory. For users who already have Person document, edit settings in the existing document as necessary to provide IMAP support. If a user does not have an existing Person document, you must create a new one. You can create a Person document manually, or use the Domino® registration process to create the Person document automatically. If you use the Domino® registration process, select IMAP in the Mail system field of the Register Person dialog box.

About this task

By default, the Domino® registration process generates a Notes® ID file (and corresponding Notes® public encryption key in the Domino® Directory) for each user in addition to creating the Person documents and mail files required by an IMAP user. Because users who will access Domino® from IMAP clients only do not require a Notes® ID, when registering these users, deselect the option to Create a Notes ID for this person. However, if a new IMAP user also requires access to Domino® from a Notes® client, Domino® Administrator client, or the Domino® Designer client, be sure to enable creation of an ID file.

The following procedure specifies the Person document settings required for IMAP users and explains how to create a Person document manually.


  1. From the Domino® Administrator, click the People & Groups tab.
  2. Select Domino Directories > Address Book > People.
  3. Do one of the following:
    • If no Person document exists for this user, click Add Person to create a new Person document.
    • Select the name of an existing Person document, and click Edit User.
  4. Click the Basics tab, complete these fields, and then click Save & Close:
    Table 1. Basics tab fields
    Field Enter
    First name

    Last name

    User name

    The login name a client uses to authenticate with the IMAP server must be unique in the Domino® Directory.

    Depending on the level of Internet access security established for the server (Server document - Security tab), the login name or user name configured on the IMAP client must match an entry in one of these fields. Entries in the User name field are always accepted as the login name. If Internet authentication is set to allow More name variations with lower security entries in the First name and Last name fields may also be accepted as login names.

    Internet password

    The password that the user enters to access the Domino® server from the IMAP client. IMAP users must have an Internet password that complies with your organization's password quality requirements.

    Mail system

    Choose IMAP if the user does not require Notes® client access.


    The name of the Notes® domain to which the server belongs.

    Mail server

    The name of the IMAP user's Domino® mail server.

    Mail file

    The path for the user's mail file, relative to the Domino® data directory -- for example, MAIL\AJONES.

    Forwarding address

    Leave this blank for users who access mail files on the Domino® server from an IMAP client.

    Internet address

    The Internet address at which the user can receive mail within your organization. This address must match the Internet address specified in the IMAP client.

    Format preference for incoming mail

    Choose one:

    • Keep in sender's format - (default) The mail file may contain messages in either Notes® rich text or MIME format. When delivering messages to the mail file, the local Router preserves the current message format. Thus messages received at the server in MIME format are stored in the mail file in MIME format, and messages received at the server in Notes® rich text format are in Notes® rich text format. When an IMAP client requests a message that is stored in Notes® rich text format, the IMAP service must convert the message to MIME before sending it to the client. Because the stored message remains in Notes® rich text format, each time an IMAP client requests the message, the IMAP service must perform the conversion.
    • Prefers MIME - The mail file stores messages in MIME format only. Choose this option for users who access mail exclusively from an IMAP client. Since IMAP clients require messages in MIME format, storing mail in MIME format ensures the best performance for IMAP users, eliminating the need for the IMAP service to convert messages before passing them to the client. In addition, using MIME storage allows the Router to add special IMAP attributes to the messages it delivers.
    • Prefers Notes® Rich Text - The mail file stores messages in Notes® format only. The Router converts messages received as MIME into Notes® rich text before delivery. In addition, the IMAP task must convert messages to MIME format when sending them to an IMAP client. To ensure the best performance, do not choose this option for users who access their Domino® mail file primarily from an IMAP client.
    When receiving unencrypted mail, encrypt before storing in your mail file

    Choose No (default); IMAP clients cannot read encrypted Notes® mail.

    To ensure that users who read mail exclusively from IMAP clients do not receive Notes-encrypted mail, remove the IMAP users' Notes® public encryption keys from their Person documents.

    Note: Never remove the Notes® public key from the Person document of users who access Notes® databases from a Notes® client.

What to do next

Complete the procedure Creating a mail file for an IMAP user.