Binom Documentation

К навигации

Tracker installation

Server Requirements

MINIMUM REQUIREMENTS

Parameter Description Note
Server type Dedicated / VPS / VDS Classic sites hosting and shared hosting will not work.
CPU (cores/threads) 2 1 is possible, but we do not guarantee performance in that case.
RAM (gb) 2 1 is possible, but we do not guarantee performance in that case.
Storage type SSD With HDD performance will fall by an order of magnitude.
OS Minimum:
Debian 8.x minimal
Ubuntu 16.xx minimal

Recommended:
Debian 9.x minimal
Ubuntu 18.04 minimal
CentOS/RHEL and LAMP-distributions are allowed in manual installation.
The optimal server configuration depends on desired performance and daily traffic volume. To simplify the selection, please check our FAQ.

Automatic installation

This type of installation allows you to install all the necessary software along with the tracker and optimize it for your server in 10 minutes. This installation can be performed only on a clean server. Do not try to install the tracker with auto installer, if you already have working projects on your server.
If you want to install the tracker on the web panel (which we highly recommend to not do), then you should check the manual method.
First, you need to connect to your server, depending on your OS, this could be done in different ways:
  • Connecting to the server
    • If you have Windows

      You need to download Putty program from here.

      Start it, in the Host Name (IP address) field enter your IP, click Open.

      In pop-up window, click "Yes"

      Enter your login

      Enter your password (input characters will not be shown on the screen), you can simply copy your password and paste it into Putty with the right mouse click.

    • If you have a Mac OS

      Use built-in Terminal application.
      Enter:
      ssh login@IP
      where login is your login, and IP is your server's IP.

      Type yes and press Enter

      Enter SSH password (input characters will not be shown on the screen), press Enter

      This window should show you:

After this, you will see the welcome screen and can proceed to the installation itself:
  • Auto installation step by steps
    • Enter:
      wget data.binom.org/binom_install.sh
      and press Enter


      Enter:
      bash binom_install.sh install
      and press Enter


      Now you need to enter a domain for the tracker, by which you can enter the tracker and which will be used for your campaign links.
      Pay attention - if your domain is already linked with your server, the installer will automatically configure SSL for it. If it is not linked, the tracker will be available only via http.
      If you do not have a domain, you can use your server's IP address.


      Enter your email:


      Select the time zone for the tracker:


      Now you need to choose place to set the tracker: in the domain root or in a subfolder.
      To set root, enter 1 and press Enter.


      At the end of the successful installation, you will see MySQL and access data:


      Be sure to save this data – it is generated at the time of installation and cannot be recovered.

VIDEO

Manual installation

SOFTWARE REQUIREMENTS

Software Minimal Recommended Note
Web Server Nginx 1.6.8
Apache2 2.2
Nginx 1.12.1 Normally, Nginx works faster and consume less resources
PHP Handler PHP5.4-FPM PHP5.6-FPM With the PHP-module for Apache2, some of tracker functional does not work
PHP Version 5.4 5.6 There is no support for PHP 7.

Required extensions:
php-pdo
php-mysqlnd
php-mbstring
php-ioncube
php-curl
php-zip
php-xmlreader
php-posix
MySQL version 5.3 Percona 5.7 Compatible with MariaDB
If you are proficient in server administration and ready to optimize the server by yourself (without our help), then you can download the latest archive of the tracker installer by this link, unzip it in desired directory of the desired domain on your server and open it in browser. The installation menu will be available there:
  • Manual step-by-step installation
    • Check the installation requirements and make sure that the software on your server meets our requirements:

      If any component is missing, you need to install it.
      At the next step, you need to set the right permissions on the tracker files, such permissions are needed so that tracker could work and update correctly by itself:

      Fill in all fields, make sure that DBMS user has SUPER privileges, so after MYSQL restart, tracker could restore global parameters for correct operation by itself. You can choose any name for your database:

      Depending on your server’s hardware and its location, the installation can take from 2 to 10 minutes:

      At the end you will see:

      After you click Finish button you will enter the login window. Login and password are the same, that you set in the third step of installation.

INSTALLATION ON WEB-PANEL ISP/PLESK/ETC

Tracker installation on ISP/Plesk/Vesta/cPanel panel is possible, but we strongly do not recommend this scenario, if you do not know how to optimize it correctly.
Almost any panel requires replacement of standard software for a more productive one and its additional configuration for the optimal tracker operation.
Typically, most panels use default settings, which can result in both a traffic loss, long reports load and reduced tracker functionality.
The FastPanel and ServerPilot panels are not supported by our tracker.

Want to help us improve this documentation page? Create a pull request