# Mmt Install

> Install MMT-Probe and its dependencies from source, packages, or Docker Use when this capability is needed.

- Skill: `tomevault-io/mmt-install` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/mmt-install`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/mmt-install/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/mmt-install

---


# MMT-Probe Installation

Guide the user through installing MMT-Probe and all its dependencies.

## Triggers

Use this skill when the user asks to:
- Install MMT-Probe or MMT-DPI
- Set up the build environment
- Compile MMT-Probe from source
- Install dependencies (hiredis, librdkafka, mongo-c-driver, etc.)
- Create .deb or .rpm packages
- Run MMT-Probe via Docker

## Important: Docker / Non-root Environments

Inside Docker containers you typically run as root, so `sudo` is neither available nor needed. All commands below use `sudo` for host installations. **In Docker containers, omit `sudo`** from every command (or define an alias: `alias sudo=''`).

To detect if you are in a Docker container:

```bash
if [ -f /.dockerenv ] || grep -q docker /proc/1/cgroup 2>/dev/null; then
    SUDO=""
    echo "Docker detected: running without sudo"
else
    SUDO="sudo"
    echo "Host detected: using sudo"
fi
```

Then use `$SUDO` in place of `sudo` throughout (e.g., `$SUDO apt-get update`).

## Prerequisites Check

### Detect the OS

```bash
OS_ID=$(grep -oP '(?<=^ID=).+' /etc/os-release | tr -d '"')
OS_VERSION=$(grep -oP '(?<=^VERSION_ID=).+' /etc/os-release | tr -d '"')
echo "Detected OS: $OS_ID $OS_VERSION"
```

### Required Software

| Software    | Min Version | Purpose                      |
|-------------|-------------|------------------------------|
| GCC         | 4.9+        | C compiler                   |
| G++         | 4.9+        | C++ compiler (static link)   |
| GNU Make    | 3.81+       | Build system                 |
| Git         | 2.0+        | Source code management       |
| libconfuse  | any         | Configuration file parsing   |
| libpcap     | any         | Packet capture               |
| MMT-DPI     | 1.7.1+      | Deep Packet Inspection lib   |

## Step 1: System Package Installation

### Debian/Ubuntu

```bash
$SUDO apt-get update
$SUDO apt-get install -y build-essential gcc g++ cpp cmake git curl
$SUDO apt-get install -y libconfuse-dev libpcap-dev
```

### RHEL/CentOS/Fedora

```bash
$SUDO yum groupinstall -y "Development Tools"
$SUDO yum install -y cmake git curl
$SUDO yum install -y libconfuse-devel libpcap-devel
```

### Verify

```bash
gcc --version    # >= 4.9
g++ --version    # >= 4.9
make --version   # >= 3.81
```

## Step 2: Install MMT-DPI (Mandatory)

MMT-DPI is the core deep packet inspection library. It **must** be installed before MMT-Probe.

```bash
TMP_DIR=$(mktemp -d -t mmt-setup-XXXXXXXXXX)
cd "$TMP_DIR"
git clone https://github.com/montimage/mmt-dpi.git mmt-dpi
cd mmt-dpi/sdk
make -j$(nproc)
$SUDO make install
$SUDO ldconfig
```

Verify: `ls /opt/mmt/dpi/lib/libmmt_core.so` and `ls /opt/mmt/dpi/include/`

## Step 3: Optional Module Dependencies

Only install libraries for the modules you need. Skip any you do not need.

| Module             | Library           | Version | Install Command |
|--------------------|-------------------|---------|-----------------|
| `REDIS_MODULE`     | hiredis           | v1.0.2  | See 3a below    |
| `KAFKA_MODULE`     | librdkafka        | v1.8.2  | See 3b below    |
| `MONGODB_MODULE`   | mongo-c-driver    | 1.9.5   | See 3c below    |
| `MQTT_MODULE`      | libpaho-mqtt      | any     | See 3d below    |
| `SECURITY_MODULE`  | MMT-Security      | any     | See 3e below    |

### 3a. Redis (hiredis v1.0.2)

```bash
cd "$TMP_DIR"
git clone https://github.com/redis/hiredis.git hiredis
cd hiredis && git checkout v1.0.2
make -j$(nproc) && $SUDO make install && $SUDO ldconfig
```

### 3b. Kafka (librdkafka v1.8.2)

```bash
$SUDO apt-get install -y libsasl2-dev libssl-dev  # Debian/Ubuntu
cd "$TMP_DIR"
git clone https://github.com/edenhill/librdkafka.git librdkafka
cd librdkafka && git checkout v1.8.2
./configure && make -j$(nproc) && $SUDO make install && $SUDO ldconfig
```

### 3c. MongoDB (mongo-c-driver 1.9.5)

```bash
$SUDO apt-get install -y pkg-config libssl-dev libsasl2-dev  # Debian/Ubuntu
cd "$TMP_DIR"
curl -Lk --output mongo-c.tar.gz https://github.com/mongodb/mongo-c-driver/releases/download/1.9.5/mongo-c-driver-1.9.5.tar.gz
tar xzf mongo-c.tar.gz && cd mongo-c-driver-1.9.5
./configure --disable-automatic-init-and-cleanup
make -j$(nproc) && $SUDO make install && $SUDO ldconfig
```

### 3d. MQTT (libpaho-mqtt)

```bash
$SUDO apt-get install -y libpaho-mqtt-dev  # Debian/Ubuntu
```

### 3e. MMT-Security

```bash
$SUDO apt-get install -y libxml2-dev libpcap-dev libconfuse-dev
cd "$TMP_DIR"
git clone https://github.com/Montimage/mmt-security.git mmt-security
cd mmt-security
make clean-all
make -j1  # Must use single thread for header generation ordering
$SUDO make install && $SUDO ldconfig
```

Verify: `ls /opt/mmt/security/lib/libmmt_security2.*`

## Step 4: Compile MMT-Probe

Navigate to the MMT-Probe source directory.

### Minimal build (file output + PCAP only)

```bash
make clean
make -j$(nproc) compile
```

### Build with selected modules

Combine any module targets before `compile`:

```bash
make -j$(nproc) KAFKA_MODULE REDIS_MODULE SECURITY_MODULE PCAP_DUMP_MODULE QOS_MODULE SOCKET_MODULE compile
```

### Available module targets

| Module Target             | Requires            |
|---------------------------|----------------------|
| `REDIS_MODULE`            | hiredis              |
| `KAFKA_MODULE`            | librdkafka           |
| `MONGODB_MODULE`          | mongo-c-driver       |
| `MQTT_MODULE`             | libpaho-mqtt         |
| `SECURITY_MODULE`         | MMT-Security + libxml2 |
| `PCAP_DUMP_MODULE`        | (none)               |
| `QOS_MODULE`              | (none)               |
| `SOCKET_MODULE`           | (none)               |
| `LTE_MODULE`              | (none)               |
| `DYNAMIC_CONFIG_MODULE`   | (none)               |
| `TCP_REASSEMBLY_MODULE`   | (none)               |
| `HTTP_RECONSTRUCT_MODULE` | (none, implies TCP)  |
| `FTP_RECONSTRUCT_MODULE`  | (none, implies TCP)  |

### Build ALL modules

```bash
make -j$(nproc) ALL_MODULES compile
```

> Requires all optional libraries from Step 3 to be installed.

### Build options

| Option           | Effect                                       |
|------------------|----------------------------------------------|
| `DEBUG`          | Enable debug symbols (`-g -O0`)              |
| `VERBOSE`        | Print detailed compilation commands          |
| `STATIC_LINK`    | Embed MMT-DPI and MMT-Security into binary   |
| `DISABLE_REPORT` | Skip DPI statistics                          |
| `SIMPLE_REPORT`  | Minimal session reports (for MMT-Box)        |
| `MMT_BASE=/path` | Custom install prefix (default: `/opt/mmt`)  |

### DPDK capture (instead of PCAP)

```bash
export RTE_SDK=/path/to/dpdk
export RTE_TARGET=build
make -j$(nproc) DPDK_CAPTURE compile
```

## Step 5: Install

```bash
$SUDO make install
# Or with modules:
$SUDO make KAFKA_MODULE REDIS_MODULE SECURITY_MODULE install
```

Installs to `/opt/mmt/probe/` (or `$MMT_BASE/probe/`):
- `bin/probe` — executable
- `mmt-probe.conf` — configuration file
- `result/report/online/` — default report output

### Create packages (optional)

```bash
make deb                          # Debian .deb
make KAFKA_MODULE REDIS_MODULE deb  # .deb with modules
make rpm                          # RHEL .rpm
```

## Docker Alternative

```bash
# Pull pre-built image
docker pull ghcr.io/montimage/mmt-probe:latest

# Or build from source
cd /path/to/mmt-probe
docker build -t mmt-probe:local .
```

## Automated Script

For a fully automated installation with all modules on Debian/Ubuntu:

```bash
$SUDO ./script/install-from-source.sh
```

This installs all dependencies, compiles with all modules, and creates a `.deb` package.

## Verification

```bash
./probe -v                  # Print version (e.g., mmt-probe 1.6.0)
./probe -h                  # Print usage help
$SUDO ./probe -t test/UA-Exp01.pcap -Xfile-output.output-dir=/tmp/mmt-test/
ls -la /tmp/mmt-test/       # Should contain report files
ldd /opt/mmt/probe/bin/probe  # All libraries resolved (no "not found")
```

## Troubleshooting

| Error | Cause | Solution |
|-------|-------|----------|
| `ERROR: Not found MMT-DPI at folder /opt/mmt/dpi` | MMT-DPI not installed | Install MMT-DPI (Step 2) |
| `Not found MMT-Security at /opt/mmt/security` | MMT-Security missing | Install it (Step 3e) or remove `SECURITY_MODULE` |
| `-lhiredis` not found | hiredis missing | Install (Step 3a) or remove `REDIS_MODULE` |
| `-lrdkafka` not found | librdkafka missing | Install (Step 3b) or remove `KAFKA_MODULE` |
| `-lmongoc-1.0` not found | mongo-c-driver missing | Install (Step 3c) or remove `MONGODB_MODULE` |
| `-lpaho-mqtt3c` not found | libpaho-mqtt missing | Install (Step 3d) or remove `MQTT_MODULE` |
| `error while loading shared libraries` | Library not in LD path | Run `ldconfig` (or `sudo ldconfig` on host) |
| Library path issues | `/usr/local/lib` not in linker path | `ldconfig -p \| grep <lib>` to check |
| `sudo: command not found` | Running inside Docker | Omit `sudo` — you are already root in Docker |

## Important Notes

- Always run `make clean` before recompiling with different modules.
- Run `ldconfig` (or `sudo ldconfig` on host) after installing any shared library.
- DPDK mode requires hugepage allocation: `echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages`

## Cross-references

- After installation, use `/mmt-configure` to set up configuration.
- To run the probe, use `/mmt-operate`.
- For general help, use `/mmt-help`.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/montimage) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->