X-Git-Url: http://www.git.stargrave.org/?p=public-inbox.git;a=blobdiff_plain;f=INSTALL;h=3a2f840caf9e55dc9aeb2161894801c3782f46c0;hp=03b356accdebc2e5835820601e588a112df17d9a;hb=4ba430497bfb4763691b0ad8af573eb6ff420b96;hpb=975a1b174d40fd957ed869e9ff68f3c6dd6f37df diff --git a/INSTALL b/INSTALL index 03b356ac..3a2f840c 100644 --- a/INSTALL +++ b/INSTALL @@ -19,54 +19,46 @@ standard MakeMaker installation (Perl) make test make install # root permissions may be needed -Requirements (server MDA) -------------------------- +Requirements +------------ * git -* SpamAssassin (spamc/spamd) -* MTA - postfix is recommended * Perl and several modules: (Debian package name) - Date::Parse libtimedate-perl - Email::MIME libemail-mime-perl - Email::MIME::ContentType libemail-mime-contenttype-perl - Encode::MIME::Header perl - - IPC::Run libipc-run-perl -Optional modules: +Optional components: + +* MTA - postfix is recommended (for public-inbox-mda) +* SpamAssassin (spamc/spamd) (for public-inbox-watch/public-inbox-mda) + +Optional Perl modules: - Plack[1] libplack-perl - - Mail::Thread (2.5+)[1] libmail-thread-perl - URI::Escape[1] liburi-perl - - Search::Xapian[3] libsearch-xapian-perl - - IO::Compress::Gzip[3] libio-compress-perl + - Search::Xapian[2][3] libsearch-xapian-perl + - IO::Compress::Gzip[3] perl-modules (or libio-compress-perl) - DBI[3] libdbi-perl - - DBD::SQLite[3] libdbd-sqlite3-perl + - DBD::SQLite[2][3] libdbd-sqlite3-perl - Danga::Socket[4] libdanga-socket-perl - - Net::Server[4] libnet-server-perl + - Net::Server[5] libnet-server-perl + - Filesys::Notify::Simple[6] libfilesys-notify-simple-perl -[1] - Only required for serving/generating Atom and HTML pages. -[3] - Optional for HTML web interface and HTTP/NNTP servers -[4] - Optional for HTTP and NNTP servers +[1] - Optional, needed for serving/generating Atom and HTML pages +[2] - Optional, only required for NNTP server +[3] - Optional, needed for gzipped mbox support over HTTP +[4] - Optional, needed for bundled HTTP and NNTP servers +[5] - Optional, needed for standalone daemonization of HTTP+NNTP servers +[6] - Optional, needed for public-inbox-watch Maildir watcher When installing Search::Xapian, make sure the underlying Xapian -is patched against the index corruption bug documented in: +installation is not affected by an index corruption bug: https://bugs.debian.org/808610 -For Debian 8.0, this means installing from jessie-backports -until the fix lands in jessie. - -# Ensure the following line is in your apt sources.list(5) -# (typically /etc/apt/sources.list): - -deb http://http.us.debian.org/debian jessie-backports main - -Then run: - - apt-get update - apt-get install -t jessie-backports libxapian22 - -to install the package. +For Debian 8.x (jessie), this means using Debian 8.5 or later. public-inbox will never store unregeneratable data in Xapian or any other search database we might use; Xapian corruption