doc/src/installation.rst
.. _Installation:
ntopng is open source and available on GitHub <https://github.com/ntop/ntopng>_. In addition, pre-compiled, binary
ntopng packages are available both for Linux and Windows. Installation
instructions for binary packages are available below.
Installation instructions can be found at http://packages.ntop.org/. Development and stable builds are available. Stable builds are intended for production environments whereas development builds are intended for testing or early feature access.
Package ^^^^^^^
MacOS installation packages can be found at
http://packages.ntop.org/ and are installed with a GUI.
ntopng requires Redis to be installed in order to start. During the ntopng installation,
if Redis is not present, Redis is installed and activated, otherwise the one already installed on
the system is used. After the installation, ntopng is started and active on local port 3000
(i.e. ntopng is available at http://127.0.0.1:3000). If you want to uninstall ntopng you can
open a terminal and type :code:sudo /usr/local/bin/ntopng-uninstall.sh
To enable geolocation, MacOS packages require database files to be manually placed under :code:/usr/local/share/ntopng/httpdocs/geoip. Detailed instructions on how to obtain database files and install them are available at https://github.com/ntop/ntopng/blob/dev/doc/README.geolocation.md/. Once the files have been downloaded and placed in the folder, a restart of ntopng is necessary to read load them.
The ntopng configuration file is installed in /usr/local/etc/ntopng/ntopng.conf that can be edited (as privileged user) with a text editor.
The ntopng service can be started/stopped using the launchctl command:
sudo launchctl load /Library/LaunchDaemons/org.ntop.ntopng.plistsudo launchctl unload /Library/LaunchDaemons/org.ntop.ntopng.plistHomebrew ^^^^^^^
brew install ntopng redisbrew services start redissudo ntopngOnly the development build binary is available for Windows. The binary can
be downloaded from the Windows package repository <https://packages.ntop.org/Windows/>_.
Download the ntopng :code:zip file from the link above, locate it in
the filesystem, and unzip it to access the actual ntopng
installer. Double-click on the installer. The installation procedure
will start and ntopng will be installed, along with its dependencies.
The installation procedure installs
Redis <https://redis.io/>_.. note::
If upgrading from an earlier version of ntopng for Windows, it is safe to skip the installation of any ntopng dependency. It is safe to respond 'No' or click 'Cancel' when prompted to install Redis.
The ntopng installer comes without capture drivers. You need to
install manually npcap drivers <https://nmap.org/npcap/>_ BEFORE you install ntopng. If Wireshark is
already installed on Windows, then npcap drivers
are already installed and no driver installation is necessary.
.. figure:: ./img/npcap.png
During npcap installation you need to select "Install Npcap in WinPcap API-compatible Mode".
In case you see a message as the one below
.. figure:: ./img/missing_pcap.png
it means that your capture drivers have not been properly installed and that you have to install them as described in this section.
Installation instructions can be found at http://packages.ntop.org/.
OPNsense installation instructions are available in the :ref:OPNsenseIntegration integration page. pfSense installation instructions are available in the :ref:pfSenseIntegration integration page.
.. note::
On some versions, the redis package comes with a default configuration that is suboptimal for OPNsense/pfSense. Please edit /usr/local/etc/redis.conf and check the line dir /var/db/redis/ that specifies where redis leeps the database. Such database must be on persistent storage (i.e. the disk) and not in the ramdisk as for instance on pfSense. In this case you can fix he problem setting it to dir /var/db/pkg/ntopng/ or to any other appropriate directory that is on persistent storage and not in ramdisk.
.. warning:: Please remember that OPNsense/pfSense devices have often limited resources. If you have to monitor a large network, we suggest you to consider running nProbe (that has limited resources usage and do not need disk stoage for keeping historical data) on OPNsense/pfSense that exports flow towards ntopng running on an host on the LAN that has more resources available.
To install ntopng (ntop tools in general) in a container, a step by step guide can be found here:
Using ntop tools on Docker <https://www.ntop.org/ntop/using-ntop-tools-including-pf_ring-zc-on-docker/>_.
The Docker images of ntop tools can be found in Docker Hub <https://hub.docker.com/u/ntop>_.
Here <https://www.ntop.org/ntop/best-practices-for-using-ntop-tools-on-containers/>_ instead an other guide regarding Best Practices for using ntop tools on Containers.
General instructions for updating the software can be found at http://packages.ntop.org/ together with the installation instructions. Depending on the Operating System.
It is also possible to check for software updates through the Web interface using the top-right menu as shown in the picture below. The system automatically checks for new updates overnight and report the new version if any. Otherwise it is also possible to force the check for new versions by clicking on Check for updates and waiting a few seconds (up to 1 minute) for the check to be performed.
Alternatively it is possible to check for update from the command line (Instructions for updating the software via command line can be found also at http://packages.ntop.org/)
.. figure:: img/software_updates_check.png :align: center :width: 400 :alt: Check for Updates
Check for Updates Menu
In the same menu, whenever a new ntopng version is available, it is possible to install it by clicking on Install update, as depicted below.
.. figure:: img/software_updates_install.png :align: center :width: 400 :alt: Install Update
Install Update
It is also possible to configure ntopng to self-update itself overnight, this can be enabled through Settings > Preferences > Updates. By default ntopng does not update itself overnight as it requires restarting the service, but if you want you can enable this preference and let ntopng do everything automatically.
.. figure:: img/software_updates_auto.png :align: center :alt: Automatic Updates
Automatic Updates Setting