1Red Hat Enterprise Linux
2========================
3
4Red Hat Enterprise Linux ships Cyrus IMAP packages as part of the base
5operating system repositories. If the base operating system has a
6subscription activated, then `Red Hat, Inc.`_ supports the package
7through the usual support channels.
8
9Currently supported versions of Red Hat Enterprise Linux include
10Cyrus IMAP packages in the repositories configured on a stock system:
11
12*   Cyrus IMAP |imap_tikanga_stock_version| for Red Hat Enterprise Linux
13    5
14
15*   Cyrus IMAP |imap_santiago_stock_version| for Red Hat Enterprise
16    Linux 6
17
18*   Cyrus IMAP |imap_maipo_stock_version| for Red Hat Enterprise Linux 7
19
20.. NOTE::
21
22    The Cyrus project does not support running any versions of the Cyrus
23    IMAP software older than the version of the software shipped
24    with the operating system itself.
25
26To install the version of Cyrus IMAP that comes with the operating
27system, issue the following command:
28
29.. parsed-literal::
30
31    # :command:`yum install cyrus-imapd cyrus-sasl cyrus-sasl-plain`
32
33Next, set a password for the default administrative user ``cyrus``:
34
35.. parsed-literal::
36
37    # :command:`passwd cyrus`
38    Changing password for user cyrus.
39    New password:
40    Retype new password:
41    passwd: all authentication tokens updated successfully.
42
43Start and configure to start when the system boots, the
44:manpage:`saslauthd` service:
45
46.. parsed-literal::
47
48    # :command:`service saslauthd start`
49    Starting saslauthd:                                        [  OK  ]
50    # :command:`chkconfig saslauthd on`
51
52You should at this moment be able to authenticate against
53:manpage:`saslauthd`:
54
55.. parsed-literal::
56
57    # :command:`testsaslauthd -u cyrus -p YOUR-PASSWORD`
58
59
60You should get an ``0: OK "Success."`` message.
61
62.. todo:: If this does not succeed, see  ref `sasl-troubleshooting-saslauthd`.
63
64Start the service, and ensure the service starts up when the system
65boots:
66
67.. parsed-literal::
68
69    # :command:`service cyrus-imapd start`
70    # :command:`chkconfig cyrus-imapd on`
71
72You should now be able to login as the ``cyrus`` user, which is
73configured by default as an administrator for Cyrus IMAP:
74
75.. parsed-literal::
76
77    # :command:`imtest -t "" -u cyrus -a cyrus localhost`
78    S: * OK [CAPABILITY IMAP4 IMAP4rev1 LITERAL+ ID STARTTLS LOGINDISABLED COMPRESS=DEFLATE] d5ec35c1414a Cyrus IMAP v2.3.16-Fedora-RPM-2.3.16-13.el6_6 server ready
79    C: S01 STARTTLS
80    S: S01 OK Begin TLS negotiation now
81    verify error:num=18:self signed certificate
82    TLS connection established: TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)
83    C: C01 CAPABILITY
84    S: * CAPABILITY IMAP4 IMAP4rev1 LITERAL+ ID AUTH=PLAIN SASL-IR COMPRESS=DEFLATE ACL RIGHTS=kxte QUOTA MAILBOX-REFERRALS NAMESPACE UIDPLUS NO_ATOMIC_RENAME UNSELECT CHILDREN MULTIAPPEND BINARY SORT SORT=MODSEQ THREAD=ORDEREDSUBJECT THREAD=REFERENCES ANNOTATEMORE CATENATE CONDSTORE SCAN IDLE LISTEXT LIST-SUBSCRIBED X-NETSCAPE URLAUTH
85    S: C01 OK Completed
86    Please enter your password:
87    C: A01 AUTHENTICATE PLAIN \*\*\*\*\*\*\*\*\*\*\*\*
88    S: A01 OK [CAPABILITY IMAP4 IMAP4rev1 LITERAL+ ID LOGINDISABLED COMPRESS=DEFLATE ACL RIGHTS=kxte QUOTA MAILBOX-REFERRALS NAMESPACE UIDPLUS NO_ATOMIC_RENAME UNSELECT CHILDREN MULTIAPPEND BINARY SORT SORT=MODSEQ THREAD=ORDEREDSUBJECT THREAD=REFERENCES ANNOTATEMORE CATENATE CONDSTORE SCAN IDLE LISTEXT LIST-SUBSCRIBED X-NETSCAPE URLAUTH] Success (tls protection)
89    Authenticated.
90    Security strength factor: 256
91    . LIST "" "*"
92    . OK Completed (0.000 secs 1 calls)
93    C: Q01 LOGOUT
94    * BYE LOGOUT received
95    Q01 OK Completed
96    Connection closed.
97
98Next, continue with :ref:`imap-configuring-the-mta`.
99
100.. _Red Hat, Inc.: https://redhat.com
101