Rspamd supports the following .deb based distributives:

• Debian wheezy (amd64, i386)
• Debian jessie (amd64, i386) Hyperscan and LuaJIT are enabled.
• Debian stretch (amd64, i386) Hyperscan and LuaJIT are enabled.
• Debian sid (amd64, i386) Hyperscan and LuaJIT are enabled.
• Ubuntu precise (amd64, i386)
• Ubuntu trusty (amd64, i386) Hyperscan and LuaJIT are enabled.
• Ubuntu xenial (amd64, i386) Hyperscan and LuaJIT are enabled.

To install the rspamd stable¹ apt repository, please use the following commands:

apt-get install -y lsb-release wget # optional
CODENAME=`lsb_release -c -s`
wget -O- https://rspamd.com/apt-stable/gpg.key | apt-key add -
echo "deb http://rspamd.com/apt-stable/ $CODENAME main" > /etc/apt/sources.list.d/rspamd.list
echo "deb-src http://rspamd.com/apt-stable/ $CODENAME main" >> /etc/apt/sources.list.d/rspamd.list
apt-get update
apt-get --no-install-recommends install rspamd

To obtain your distributive’s codename, you could use the command lsb_release -s -c from the package called lsb-release.

For Hyperscan and LuaJIT information see the FAQ.

For experimental² branch replace apt-stable with just apt:

apt-get install -y lsb-release wget # optional
CODENAME=`lsb_release -c -s`
wget -O- https://rspamd.com/apt/gpg.key | apt-key add -
echo "deb http://rspamd.com/apt/ $CODENAME main" > /etc/apt/sources.list.d/rspamd.list
echo "deb-src http://rspamd.com/apt/ $CODENAME main" >> /etc/apt/sources.list.d/rspamd.list
apt-get update
apt-get --no-install-recommends install rspamd

Check quick start for further steps.

Debian official repos

Rspamd is also available in some versions of Debian and Ubuntu. However, we are looking for an active maintainer for rspamd in these ‘official’ repos, as now rspamd is terribly outdated there.

Please DO NOT use those packages, as they are no longer supported.

Rspamd is also supported on the following Linux distributions:

• Alpine Linux
• Arch Linux
• Gentoo Linux
• OpenSUSE
• Void Linux

Alpine Linux

Rspamd is available in the testing repository

Arch Linux

Rspamd is available in the AUR

Gentoo Linux

Ebuilds for Gentoo Linux users are available in the main Gentoo Portage repository.

OpenSUSE

Packages for OpenSUSE Leap & Tumbleweed are available on OBS.

Void Linux

Packages for Void Linux are available in the main package repository.

Rspamd has been ported to the following BSD like operating systems:

• FreeBSD
• NetBSD
• OpenBSD
• OSX (using MacPorts)

FreeBSD users can install Rspamd from ports or use the experimental line of packages by rspamd-devel port.

Users of NetBSD (and other systems with pkgsrc) can use pkgsrc.

OpenBSD users can use ports.

OSX users can install from MacPorts.

If there are no packages for your system or you want custom build options you can also build rspamd from the source code. To do that grab the source from github using git:

git clone --recursive https://github.com/vstakhov/rspamd.git

There is also a mirror of rspamd repository: https://git.rspamd.com/vstakhov/rspamd

Build requirements

Rspamd requires several 3-rd party software to build and run:

• openssl - cryptography and SSL/TLS Toolkit
• libevent - asynchronous event library
• glib2 - common purposes library
• ragel - state machine compiler. Please be aware that the experimental version of Ragel (namely, 7.0) is NOT compatible with Rspamd. Since it is shipped with CentOS 7.0, there is no way to use Ragel from the packages and you need to build compatible Ragel (e.g. 6.8) manually from the source packages or from source code. Ragel is required to build Rspamd not to run it.
• Luajit - jit compiler for lua programming language. Plain lua will work as well.
• cmake - build system used to configure rspamd
• sqlite3 - embedded database used to store some data by rspamd
• libmagic - common library for detecting file types
• libfann - neural nets library (or pass -DENABLE_FANN=OFF to cmake)

You can either install them from sources or (recommended) install using package manager of your system.

Build process

To build rspamd we recommend to create a separate build directory:

$ mkdir rspamd.build
$ cd rspamd.build
$ cmake ../rspamd
$ make
# make install

Alternatively, you can create a distribution package and use it for build your own packages. Here is an example for debian GNU Linux OS:

$ mkdir rspamd.build
$ cd rspamd.build
$ cmake ../rspamd
$ make dist
$ tar xvf rspamd-<rspamd_version>.tar.xz
$ cd rspamd-<rspamd_version>
$ debuild