This program receives flows (currently NetFlow/IPFIX and sFlow), enriches them with interface names (using SNMP), geo information (using IPinfo.io), and exports them to ClickHouse. It also exposes a web interface to browse the collected data.
Akvorado is developed by Free, a French ISP, and is licensed under the AGPLv3 license.
A demo site using fake data and running the latest stable version is
available on demo.akvorado.net. It is the
direct result of running docker compose up on a fresh checkout but
flow ports are not accessible (you cannot send your own flows). Please,
be gentle with this resource. The demo site also enables you to browse
the documentation for the current version
(the one in docs/ is for the next version).
By default, Akvorado is using IPinfo databases for geolocation data.
A Grafana plugin is available.
Caution
Be sure to always read the changelog before upgrading.
The first step is to read the documentation. It ships with Akvorado: the running console serves the version you use, under the “Documentation” tab.
It is organized with the Diátaxis framework, in four parts: tutorials, how-to guides, reference and explanation. Good entry points are:
- the introduction,
- the tutorial,
- the configuration reference, and
- the troubleshooting guide.
If you still need help, you can use the discussions. Be sure to explain what you tried to solve your problem. Enclose code using triple backticks:
```
# akvorado version | head -2
akvorado v1.11.2
Built with: go1.23.2 X:loopvar
```