BitNinja Quick Start Guide

This tutorial will show you how to quick install BitNinja on your server.

Hardware requirements

Minimum server requirements for the flawless operation of BitNinja:
  • RAM: 512 M
  • Dual-core CPU
  • Storage: 1024M
  • Internet access

Please note that if you are using other services you may need more RAM.

Software requirements

BitNinja supports most modern Linux distributions. We have packages for .deb and .rpm based Linux systems and do automatic testing for the following distributions:

  • CentOS 6 64 bit
  • CloudLinux 6
  • Debian 6 64 bit
  • Debian 7 64 bit
  • Ubuntu 14 64 bit

BitNinja is also compatible with these Linux distributions:

  • CentOS 7 and up
  • CloudLinux 7 and up
  • Debian 8 and up
  • OpenSUSE 42.3 (See details at the OpenSUSE 42.3 section)
  • RedHat 6 and up
  • Ubuntu 15 and up

BitNinja can be installed on Virtuozzo / OpenVZ https://docs.bitninja.io/serverprotection/doc/#virtuozzo-openvz

Port requirements

Some BitNinja modules require certain ports to be open on the server. The following port numbers are the default values.

Protocol

Port

BitNinja module(s)

TCP

60412

CaptchaHttp, CaptchaSmtp

TCP

60413

CaptchaHttps

TCP

25

CaptchaSmtp

TCP

60201

CaptchaSmtp

TCP

60210

CaptchaFtp (active)

TCP

60211-60250

CaptchaFtp (passive)

TCP

60300

WAF HTTP

TCP

60301

WAF HTTPS

TCP

60414

SSL-termination

Install BitNinja

The easiest way to install BitNinja is by using universal one-line installer.

The safest choice is to use the universal installer. The universal installer is a one-line command you can use to begin the BitNinja installation on your server. It will detect the distribution and version of your Linux operating system and install BitNinja.

wget -qO- https://get.bitninja.io/install.sh | /bin/bash -s - --license_key=****your_license_key******
Note

Don’t forget to set the license key! BitNinja uses this 16 byte long string to connect your server to your profile. In the example below it is **your_license_key**** but in reality you can obtain it by logging in to https://admin.bitninja.io and clicking on the Add Server button or visiting the settings page https://admin.bitninja.io/settings/general. Look for the API key.

WHM

If you’d like to install BitNinja into WHM, all you need to do is run the following command in your Linux terminal:

wget -qO- https://get.bitninja.io/bitninja-whm.tar.gz | tar -zx && ./bitninja-whm/install --license_key=****your_license_key******
Note

You can obtain your custom license key by logging in to https://admin.bitninja.io and clicking on the Add Server button or visiting the settings page https://admin.bitninja.io/settings/general. Look for the API key.

If you already have BitNinja installed, you can use the –no_install_bitninja flag to install BitNinja into WHM without downloading the full installer itself. To do this, run the following command:

wget -qO- https://get.bitninja.io/bitninja-whm.tar.gz | tar -zx && ./bitninja-whm/install --no_install_bitninja

Alternative methods

If you have curl installed, you can also use the following commands for installation:

curl https://get.bitninja.io/bitninja-whm.tar.gz | tar -zx && ./bitninja-whm/install --license_key=****your_license_key******

And without downloading the full installation script:

curl https://get.bitninja.io/bitninja-whm.tar.gz | tar -zx && ./bitninja-whm/install --no_install_bitninja

ISPmanager

If you’d like to install BitNinja into ISPmanager, all you need to do is run the following command in your Linux terminal:

 
wget -qO- https://get.bitninja.io/ispmgr-plugin.tar.gz | tar -zx && ./ispmgr-plugin/install --license_key=****your_license_key******
Note

You can obtain your custom license key by logging in to https://admin.bitninja.io and clicking on the Add Server button or visiting the settings page https://admin.bitninja.io/settings/general. Look for the API key.

Alternative methods

If you have curl installed, you can also use the following commands for installation:

curl https://get.bitninja.io/ispmgr-plugin.tar.gz | tar -zx && ./ispmgr-plugin/install --license_key=****your_license_key******
Tagged: