Operating System CentOS

How to Install ntopng on Ubuntu 26.04, Debian 13, AlmaLinux and Rocky Linux

Install the ntopng network traffic monitor from ntop's stable repository on Ubuntu, Debian, AlmaLinux or Rocky Linux and reach the dashboard over HTTPS.

ntopng is a web-based network traffic monitor: it watches one or more interfaces and shows live hosts, flows, protocols and alerts in a browser. This guide installs the current stable release (ntopng 7.0 at the time of writing) from ntop's own package repository on Ubuntu 26.04 LTS, Debian 13, and AlmaLinux or Rocky Linux 9 and 10, and gets you to a working, password-protected dashboard running the free Community edition.

ntop publishes stable packages for Ubuntu 26.04, 24.04 and 22.04, Debian 13, 12 and 11, and the RHEL family 8, 9 and 10, all for 64-bit x86. ntop itself suggests Ubuntu Server LTS or Rocky Linux. CentOS 7 reached end of life in June 2024 and is no longer a target; use AlmaLinux or Rocky Linux instead. Distribution repositories also carry an ntopng package, but it is usually much older than the upstream build.

Requirements

  • A 64-bit x86 server running one of the systems above, with root access. Commands below are run as root; prefix them with sudo if you work as a regular user.
  • The name of the network interface to monitor. List interfaces with ip -br link.
  • Access to TCP port 3001 from your own computer for the web interface.

Editions and licensing

ntopng comes in a Community edition, which is free and open source and needs no license, and in Professional and Enterprise editions, which need a license from ntop. The same package serves all of them; which edition runs depends on whether a license is present. Community is enough to monitor the traffic of a server or a small network and is limited to 8 monitored interfaces. Universities, non-profits and research organisations can request the commercial editions at no cost.

Step 1: Add the ntop repository

Ubuntu 26.04 LTS and 24.04 LTS

The packages depend on software from the universe component. Enable it, then download and install the small package that registers the repository and its signing key. For Ubuntu 24.04 replace 26.04 with 24.04 in the URL:

apt update
apt install software-properties-common wget whiptail
add-apt-repository universe
wget https://packages.ntop.org/apt-stable/26.04/all/apt-ntop-stable.deb
apt install ./apt-ntop-stable.deb

Debian 13 and 12

Enable the contrib component first. On installations that use /etc/apt/sources.list, add contrib to the end of each line that begins with deb or deb-src; on installations that use /etc/apt/sources.list.d/debian.sources, add it to each Components: line. Then run the following; for Debian 12 replace trixie with bookworm:

apt update
apt install lsb-release wget gnupg apt-transport-https ca-certificates whiptail
wget https://packages.ntop.org/apt-stable/trixie/all/apt-ntop-stable.deb
apt install ./apt-ntop-stable.deb

ntop also has a nightly repository under packages.ntop.org/apt/ with development builds. The URLs above are the stable ones.

AlmaLinux and Rocky Linux 9 and 10

Add the repository file, then enable EPEL, which provides several dependencies. The CRB step is needed on version 9 only; skip it on version 10:

curl https://packages.ntop.org/centos-stable/ntop.repo > /etc/yum.repos.d/ntop.repo
dnf config-manager --set-enabled crb
dnf install epel-release

Step 2: Install ntopng

ntop's instructions use ntop-installer, a text-menu tool that lets you tick the ntop products to install. On Debian and Ubuntu it is available once the repository package is in place:

apt clean all
apt update
ntop-installer

On AlmaLinux and Rocky Linux install it first:

dnf install ntop-installer
ntop-installer

Select ntopng and leave the licensed products (nProbe, n2disk) unselected unless you have a license for them. If you prefer a non-interactive install, request the package directly with apt install ntopng or dnf install ntopng. Either way the package manager pulls in the dependencies, including the Redis server that ntopng uses for its preferences and user accounts.

Step 3: Configure ntopng

The service reads /etc/ntopng/ntopng.conf; the packages create a default one. The file holds the same options as the command line, one per line, and every option must be written as name=value, with the = present even when the option takes no value. A small configuration for one interface:

# Interface to monitor
--interface=eth0
# Networks to treat as local (your own address ranges)
--local-networks=203.0.113.0/24
# Run as the free Community edition
--community=

Replace eth0 and the network with your own values. Repeat --interface on separate lines to monitor more than one interface. The helper ntopng-config offers a menu for the most common settings if you would rather not edit the file by hand.

Enable the service at boot and restart it so the configuration is applied:

systemctl enable ntopng
systemctl restart ntopng
systemctl status ntopng

If the service does not stay up, read its log with journalctl -u ntopng -e. The most common causes are a misspelled interface name and a Redis server that is not running.

Step 4: Open the web interface

Freshly installed packages disable plain HTTP and serve the interface over HTTPS on port 3001 with a self-signed certificate. Open the port for your own address only; the dashboard exposes details about every host on your network.

With UFW on Ubuntu or Debian (replace 198.51.100.25 with the address you connect from):

ufw allow from 198.51.100.25 to any port 3001 proto tcp

With firewalld on AlmaLinux or Rocky Linux:

firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="198.51.100.25" port port="3001" protocol="tcp" accept'
firewall-cmd --reload

Browse to https://203.0.113.10:3001/ and accept the certificate warning. Log in with the user admin and the password admin; ntopng asks you to set a new password immediately. After that the dashboard shows the top talkers, active flows and application protocols seen on the monitored interface.

Step 5: Verify

  • ss -ltnp | grep ntopng shows the process listening on port 3001.
  • In the web interface, the interface selector at the top lists the interface you configured, and its throughput counters move when there is traffic.
  • The About entry in the help menu shows the version and the edition in use.

Maintenance

Updates arrive through the package manager like any other package:

apt update && apt upgrade
dnf upgrade

If you lose the administrator password, delete it from Redis and restart the service; the login is then admin / admin again:

redis-cli del ntopng.user.admin.password
systemctl restart ntopng

To use your own TLS certificate, change ports or put ntopng behind a reverse proxy, see the ntopng user's guide. The repository pages at packages.ntop.org list the currently supported distributions.

Frequently asked questions

Can ntopng monitor traffic of other machines, not only the server it runs on?

It sees whatever reaches the monitored interface. On a single VPS that is the server's own traffic. To watch a whole network, feed ntopng a mirror (SPAN) port, run it on the gateway, or collect NetFlow/sFlow from routers through nProbe, which is a separately licensed ntop product.

How do I switch the interface to another port or to plain HTTP?

Set --https-port= and --http-port= in /etc/ntopng/ntopng.conf. The built-in defaults are 3001 for HTTPS and 3000 for HTTP, and an address can be put before the port, for example --http-port=:3000 to listen on localhost only behind a reverse proxy. Restart the service afterwards.

Is there a Docker image or a FreeBSD package?

ntop publishes Docker images of its tools on Docker Hub and builds packages for FreeBSD, OPNsense and pfSense, as well as Windows, macOS and Raspberry Pi OS. The download page links to each of them.

Where does ntopng keep its data?

Runtime data and time series are stored under /var/lib/ntopng by default, and preferences and user accounts in Redis. Include both in backups if you want to keep history and settings.

Share story:

Continue reading other guides on How VPS.