Schleuder/ documentation/ v2.2/


Installing schleuder is quite simple if "ruby", "gem" and "MTA" are no unknown words to you.

Note: if you are installing on Debian GNU/Linux 5.0, please refer to ?installationdebian, too.


  • A functional MTA (postfix, qmail, exim, ...). Without an MTA schleuder is pretty much useless. Which one you choose is up to you, we're not aware of any MTA that can't run schleuder.

  • ruby >=1.8.6.

  • gnupg = 1.x

  • gpgme >= 1.1 (sometimes called libgpgme.)

All other dependencies are packaged as rubygems and will be installed automatically.

We strongly advise to use encrypted filesystems! Sensitive data will be written to disk!

Installing and setting up

  1. Install the code and most of its dependencies: gem install schleuder.
  2. Install the last dependency: schleuder-fix-gem-dependencies.
  3. Initially set up schleuder: schleuder-init-setup.
  4. Open the files in /etc/schleuder in your preferred editor and possibly make some changes.
  5. Create two directories: one to store the lists-data in (according to the 'lists_dir'-setting in schleuder.conf), one to store the global log-file in ('log_file' in schleuder.conf). By default that's /var/schleuderlists and /var/log/schleuder.
  6. Check file-system permissions: The user that runs your MTA needs read and write permissions to those two directories you just created and all included files.

  7. If you use a more advanced setup with different users for different lists (For example: ?configurationeximplus) you need to adapt the permissions accordingly.


Schleuder expects a listname as first argument and the incoming email on stdin:

/path/to/bin/schleuder listname@hostname < email-file

To enable it receiving emails you need to hook it into your MTA by setting up some email-aliases per list, see creating lists.