# Installation Guide 

<accordion>
    
<panel>
        <label><title> 🧩 Installation from Binary Packages (Recommended)</title> </label>
        ### ✅ Supported Distributions 

Currently, we support packages for [[https://en.wikipedia.org/wiki/Category:RPM-based_Linux_distributions|RPM-based Linux distributions]].  
Packages are built and served via the [[https://copr.fedorainfracloud.org/coprs/g/CESNET/NEMEA-stable/|COPR infrastructure]] under the **NEMEA-stable** group.

----

### Installation Steps 

**1️⃣ Install the COPR plugin for** ''dnf''.
<code bash>
sudo dnf install -y dnf-plugins-core
</code>

**2️⃣ Enable the [[https://copr.fedorainfracloud.org/coprs/g/CESNET/NEMEA-stable/|NEMEA-stable]] and [[https://copr.fedorainfracloud.org/coprs/g/CESNET/ipfixprobe/packages/|ipfixprobe]] COPR repository**.

<code bash>
sudo dnf copr enable @CESNET/NEMEA-stable
sudo dnf copr enable @CESNET/ipfixprobe
</code>

**3️⃣ Install ipfixprobe**.

To install ipfixprobe, run:

<code bash>
sudo dnf install ipfixprobe
</code>

**4️⃣ (optional) Install additional plugins**.

<note>ℹ️ Checkout our [[en:plugins|plugin guide]] for instruction on plugin installation.</note>

</panel>



<panel>
        <label> <title>📦 Build from Source </title></label>
        The source code of **ipfixprobe** is hosted on [[https://github.com/CESNET/ipfixprobe|GitHub]].

----

### Installation Steps 

**1️⃣ Add additional repositories**.
<code bash>
sudo yum-config-manager --add-repo https://yum.oracle.com/repo/OracleLinux/OL9/codeready/builder/x86_64/
</code>

**2️⃣ Install required dependencies**.  
<code bash>
sudo dnf install -y wget curl net-tools gcc gcc-c++ git libtool lz4 rpm-build fuse3-devel make cmake rpm libatomic libunwind openssl-devel pkgconf-pkg-config
</code>

**3️⃣ Install [[https://github.com/CESNET/telemetry|Telemetry library]]**. (required for ipfixprobe)  
<code bash>
git clone https://github.com/CESNET/telemetry.git
cd telemetry
make install
</code>

**4️⃣ Clone the ipfixprobe repository**. 
<code bash>
git clone https://github.com/CESNET/ipfixprobe.git
cd ipfixprobe
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr .. 
cd ..
</code>

➡️ Ipfixprobe is expected to be installed in ''/usr/bin/ipfixprobe/'' for **scripts to work** out of the box. 

You can **change** the installation directory with ''-DCMAKE_INSTALL_PREFIX=path''

ℹ️ CMake options:
  ***ENABLE_MILISECONDS_TIMESTAMPS** : Enable milliseconds timestamps precision.
  ***ENABLE_NEMEA** : Enable ipfixprobe to be used as [[https://github.com/CESNET/Nemea?tab=readme-ov-file|NEMEA (Network Measurements Analysis)]] module.
  ***ENABLE_RPMBUILD** : Enable build of RPM package.
  ***ENABLE_TESTS** : Build tests (make test).



<note>💡 See our [[en:plugins|Plugin Guide]] for instruction on plugin installation.</note>

**5️⃣ Compile and install ipfixprobe**. 

<code bash>
make -j
sudo make install
</code>

</panel>

<panel>
<label><title>📡 Installation on OpenWrt Routers</title> </label>


**Ipfixprobe** can be deployed on routers running [[https://openwrt.org/start|OpenWrt]].


### Turris OS (OpenWrt-based) 

Installation can be done via SSH (below) or through the LUCI web interface.

**1️⃣ Update package list**.

<code bash>
opkg update
</code>

**2️⃣ Install ipfixprobe**.

<code bash>
opkg install ipfixprobe
</code>

**3️⃣ Enable LUCI configuration (Optional)**.

<code bash>
opkg install luci-app-ipfixprobe
</code>

----

### Other OpenWrt Routers 

To install ipfixprobe, you’ll most likely need to compile a package manually.  
For details, see the [[https://github.com/CESNET/Nemea-OpenWRT|NEMEA OpenWrt feed]] or contact us.

</panel>
</accordion>