1.. _imap-installation-distributions-debian: 2 3Debian 4====== 5 6Currently supported versions of Debian include Cyrus IMAP packages in 7the repositories configured on a stock system. 8 9 10.. NOTE:: 11 12 The Cyrus project does not support running any versions of the Cyrus 13 IMAP software older than the version of the software shipped 14 with the operating system itself. 15 16To install the version of Cyrus IMAP that comes with the operating 17system, issue the following command: 18 19.. parsed-literal:: 20 21 # :command:`apt-get install cyrus-imapd cyrus-sasl cyrus-sasl-plain` 22 23If you want xapian, you'll need to :ref:`build all of Cyrus yourself <compiling>`. 24 25Next, set a password for the default administrative user ``cyrus``: 26 27.. parsed-literal:: 28 29 # :command:`passwd cyrus` 30 Changing password for user cyrus. 31 New password: 32 Retype new password: 33 passwd: all authentication tokens updated successfully. 34 35Start and configure to start when the system boots, the 36:manpage:`saslauthd` service: 37 38.. parsed-literal:: 39 40 # :command:`service saslauthd start` 41 Starting saslauthd: [ OK ] 42 # :command:`chkconfig saslauthd on` 43 44You should at this moment be able to authenticate against 45:manpage:`saslauthd`: 46 47.. parsed-literal:: 48 49 # :command:`testsaslauthd -u cyrus -p YOUR-PASSWORD` 50 51You should get an ``0: OK "Success."`` message. 52 53.. todo:: 54 If this does not succeed, see ref:`sasl-troubleshooting-saslauthd`. 55 56Start the service, and ensure the service starts up when the system 57boots: 58 59.. parsed-literal:: 60 61 # :command:`service cyrus-imapd start` 62 # :command:`chkconfig cyrus-imapd on` 63 64You should now be able to login as the ``cyrus`` user, which is 65configured by default as an administrator for Cyrus IMAP: 66 67.. parsed-literal:: 68 69 # :command:`imtest -t "" -u cyrus -a cyrus localhost` 70 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 71 C: S01 STARTTLS 72 S: S01 OK Begin TLS negotiation now 73 verify error:num=18:self signed certificate 74 TLS connection established: TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits) 75 C: C01 CAPABILITY 76 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 77 S: C01 OK Completed 78 Please enter your password: 79 C: A01 AUTHENTICATE PLAIN \*\*\*\*\*\*\*\*\*\*\*\* 80 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) 81 Authenticated. 82 Security strength factor: 256 83 . LIST "" "*" 84 . OK Completed (0.000 secs 1 calls) 85 C: Q01 LOGOUT 86 * BYE LOGOUT received 87 Q01 OK Completed 88 Connection closed. 89 90Next, continue with :ref:`imap-configuring-the-mta`. 91