chiark - git - mdw - qmail/blob - INSTALL

   1 SAVE COPIES OF YOUR OUTGOING MAIL! Like any other piece of software (and
   2 information generally), the qmail system comes with NO WARRANTY. It's
   3 much more secure and reliable than sendmail, but that's not saying much.
   4
   5
   6 Things you have to decide before starting:
   7
   8 * The qmail home directory, normally /var/qmail. To change this
   9 directory, edit conf-qmail now.
  10
  11 * The names of the qmail users and the qmail groups. To change these
  12 names, edit conf-users and conf-groups now.
  13
  14
  15 To create /var/qmail and configure qmail (won't interfere with sendmail):
  16
  17  1. Create the qmail home directory:
  18        # mkdir /var/qmail
  19
  20  2. Read INSTALL.ids. You must set up the qmail group and the qmail
  21     users before compiling the programs.
  22
  23  3. Compile the programs and create the qmail directory tree:
  24        # make setup check
  25
  26  4. Read INSTALL.ctl and FAQ. Minimal survival command:
  27        # ./config
  28
  29  5. Read INSTALL.alias. Minimal survival command:
  30        # (cd ~alias; touch .qmail-postmaster .qmail-mailer-daemon .qmail-root)
  31        # chmod 644 ~alias/.qmail*
  32
  33  6. Read INSTALL.mbox and INSTALL.vsm.
  34
  35  7. Read INSTALL.maildir.
  36
  37  8. Copy /var/qmail/boot/home (or proc) to /var/qmail/rc.
  38
  39
  40 To test qmail deliveries (won't interfere with sendmail):
  41
  42  9. Enable deliveries of messages injected into qmail:
  43        # csh -cf '/var/qmail/rc &'
  44
  45 10. Read TEST.deliver.
  46
  47
  48 To upgrade from sendmail to qmail:
  49
  50 11. Read SENDMAIL. This is what your users will want to know about the
  51     switch from sendmail to qmail.
  52
  53 12. Read REMOVE.sendmail. You must remove sendmail before installing
  54     qmail.
  55
  56 13. Read REMOVE.binmail.
  57
  58 14. Add
  59             csh -cf '/var/qmail/rc &'
  60     to your boot scripts, so that the qmail daemons are restarted
  61     whenever your system reboots. Make sure you include the &.
  62
  63 15. Make qmail's ``sendmail'' wrapper available to MUAs:
  64        # ln -s /var/qmail/bin/sendmail /usr/lib/sendmail
  65        # ln -s /var/qmail/bin/sendmail /usr/sbin/sendmail
  66     /usr/sbin might not exist on your system.
  67
  68 16. Set up qmail-smtpd in /etc/inetd.conf (all on one line):
  69             smtp stream tcp nowait qmaild /var/qmail/bin/tcp-env
  70             tcp-env /var/qmail/bin/qmail-smtpd
  71
  72 17. Reboot. (Or kill -HUP your inetd and make sure the qmail daemons
  73     are running.)
  74
  75 18. Read TEST.receive.
  76
  77
  78
  79 That's it! To report success:
  80        % ( echo 'First M. Last'; cat `cat SYSDEPS` ) | mail djb-qst@cr.yp.to
  81 Replace First M. Last with your name.
  82
  83 If you have questions about qmail, join the qmail mailing list; see
  84 http://pobox.com/~djb/qmail.html.