Rspamd packages

CentOS, Fedora

Supported distributions:

  • CentOS 6 (amd64), need EPEL
  • CentOS 7 (amd64), need EPEL
  • Fedora 21 (amd64)
  • Fedora 22 (amd64)
  • Fedora 23 (amd64)

Please note that CentOS rpm packages requires EPEL to be installed in your system as many dependencies are missing from the base CentOS repositories. You can learn how to install EPEL from their site: https://fedoraproject.org/wiki/EPEL. Fedora packages do not require EPEL or any other third-party repository.

To install rspamd repo, please download the corresponding repository file and the signing key (both repo and all packages are signed with my GPG key). You could use the following commands to install rspamd stable1 RPM repository:

curl http://rspamd.com/rpm-stable/${YOUR_DISTRO}/rspamd.repo > /etc/yum.repos.d/rspamd.repo
rpm --import http://rspamd.com/rpm-stable/gpg.key
yum update
yum install rspamd

Where ${YOUR_DISTRO} is the short name of your os (e.g. centos-7 or fedora-22).

For experimental2 branch packages, download rpm-experimental repofile as following:

curl http://rspamd.com/rpm-stable/${YOUR_DISTRO}/rspamd-experimental.repo > /etc/yum.repos.d/rspamd-experimental.repo
rpm --import http://rspamd.com/rpm/gpg.key
yum update
yum install rspamd    

1. Use STABLE branch of packages: those packages are the official rspamd releases which are recommended for production usage.

2. Use EXPERIMENTAL branch of packages: these packages are less stable and they are generated frequently from the current development branch. Experimental packages usually have more features but might be SOMETIMES broken in some points (nevertheless, bugs are usually quickly fixed after detection).

Debian and Ubuntu Linux

Rspamd supports the following .deb based distributives:

  • Debian wheezy (amd64, i386)
  • Debian jessie (amd64, i386)
  • Debian sid (amd64, i386)
  • Ubuntu precise (amd64, i386)
  • Ubuntu trusty (amd64, i386)
  • Ubuntu wily (amd64, i386)
  • Ubuntu xenial (amd64, i386)

To install the rspamd stable1 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 experimental2 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.


1. Use STABLE branch of packages: those packages are the official rspamd releases which are recommended for production usage.

2. Use EXPERIMENTAL branch of packages: these packages are less stable and they are generated frequently from the current development branch. Experimental packages usually have more features but might be SOMETIMES broken in some points (nevertheless, bugs are usually quickly fixed after detection).

Other Linux

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.

BSD systems

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.

Build rspamd from the sources

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.org/vstakhov/rspamd

Please note that --recursive option is essential for building rspamd, since the repository contains some submodules that must be initialized prior to the build process.

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
  • gmime2 - mime parser (untill Rspamd 1.5)
  • ragel - state machine compiler
  • 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

Further reading

Please check the quickstart guide that describes the subsequent steps to keep rspamd up and running. The most frequently asked questions are listed in the FAQ.

Reporting bugs and other issues

Please check the support page