Skip to content

Latest commit

 

History

History
145 lines (105 loc) · 4.64 KB

INSTALL.md

File metadata and controls

145 lines (105 loc) · 4.64 KB
Raw

Table of Contents:

Please report any errors you encounter at https://github.com/certtools/intelmq/issues

For upgrade instructions, see UPGRADING.md. For setting up a development environment see the Developer's Guide section Development Environment. For testing pre-releases see also the Developer's Guide section Testing Pre-releases.

Requirements

The following instructions assume the following requirements:

Supported and recommended operating systems are:

  • CentOS 7
  • Debian 8, 9 and 10
  • OpenSUSE Leap 15.0 and 15.1
  • Ubuntu: 16.04, 18.04 and 19.04

Other distributions which are (most probably) supported include RHEL, Fedora and openSUSE Tumbleweed.

Install Dependencies

If you are using native packages, you can simply skip this section as all dependencies are installed automatically.

Debian 8

apt-get install python3 python3-pip
apt-get install build-essential libffi-dev
apt-get install python3-dev
apt-get install redis-server

Special note for Debian 8: if you are using Debian 8, you need to install this package extra: apt-get install libgnutls28-dev. In addition, Debian 8 has an old version of pip3. Please get a current one via:

curl "https://bootstrap.pypa.io/get-pip.py" -o "/tmp/get-pip.py"
python3.4 /tmp/get-pip.py

Ubuntu 16.04 / Ubuntu 18.04 / Debian 9

apt install python3-pip python3-dnspython python3-psutil python3-redis python3-requests python3-termstyle python3-tz python3-dateutil
apt install redis-server

Optional dependencies:

apt install bash-completion jq
apt install python3-sleekxmpp python3-pymongo python3-psycopg2

CentOS 7 / RHEL 7

yum install epel-release
yum install python34 python34-devel
yum install gcc gcc-c++
yum install redis

Install the last pip version:

curl "https://bootstrap.pypa.io/get-pip.py" -o "/tmp/get-pip.py"
python3.4 /tmp/get-pip.py

openSUSE 15.0 / 15.1

zypper install python3-dateutil python3-dnspython python3-psutil python3-pytz python3-redis python3-requests python3-python-termstyle
zypper install redis

Optional dependencies:

zypper in bash-completion jq
zypper in python3-psycopg2 python3-pymongo python3-sleekxmpp

Installation

Installation methods available:

  • native packages (.deb, .rpm)
  • PyPi (latest releases as python package)

Note: installation for development purposes must follow the instructions available on Developers Guide.

Native Packages

Supported Operating Systems:

  • CentOS 7 (requires epel-release)
  • Debian 8 (requires python3-typing)
  • Debian 9
  • Debian 10
  • Fedora 29
  • Fedora 30
  • RHEL 7 (requires epel-release)
  • openSUSE Leap 15.0
  • openSUSE Leap 15.1
  • openSUSE Tumbleweed
  • Ubuntu 16.04 (enable the universe repositories by appending universe in /etc/apt/sources.list to deb http://[...].archive.ubuntu.com/ubuntu/ xenial main)
  • Ubuntu 18.04 (enable the universe repositories by appending universe in /etc/apt/sources.list to deb http://[...].archive.ubuntu.com/ubuntu/ bionic main)
  • Ubuntu 19.04 (enable the universe repositories by appending universe in /etc/apt/sources.list to deb http://[...].archive.ubuntu.com/ubuntu/ disco main)

Get the installation instructions for your operating system here: Installation Native Packages.

Please report any errors or improvements at IntelMQ Issues. Thanks!

PyPi

sudo -i

pip3 install intelmq

useradd -d /opt/intelmq -U -s /bin/bash intelmq
sudo intelmqsetup

Additional Information

Following any one of the installation methods mentioned before setup the IntelMQ base. However, some bots have additional dependencies which are mentioned in their own documentation available on this directory.

Afterwards

Now continue with the User Guide.