Skip to content

Installation

Jump to bottom
Iyotee edited this page Aug 24, 2025 · 1 revision

Installation Guide

📦 System Requirements

Operating Systems

  • Windows 10/11 (64-bit)
  • macOS 10.13+ (64-bit)
  • Linux (Ubuntu 18.04+, CentOS 7+, etc.)

Hardware Requirements

  • RAM: 4GB minimum, 8GB recommended
  • Storage: 500MB free space
  • Network: Ethernet or Wi-Fi adapter
  • CPU: Multi-core processor (2+ cores)

Software Dependencies

  • Windows: Npcap (included in installer)
  • Linux: libpcap-dev
  • macOS: libpcap (included in macOS)

🚀 Quick Installation

Windows Users

Option 1: Installer (Recommended)

  1. Download DHCP Monitor Pro_1.1.37_x64-setup.exe from Releases
  2. Right-click the installer and select "Run as administrator"
  3. Follow the installation wizard
  4. Launch from Start Menu or Desktop shortcut

Option 2: Portable Version

  1. Download the portable package
  2. Extract to any folder
  3. Right-click DHCP Monitor Pro.exe → "Run as administrator"

macOS Users

Option 1: DMG Installer

  1. Download DHCP Monitor Pro_1.1.37_x64.dmg
  2. Double-click the DMG file
  3. Drag the app to Applications folder
  4. Launch from Applications

Option 2: AppImage (Linux compatibility)

  1. Download the AppImage file
  2. Make executable: chmod +x DHCPMonitor-*.AppImage
  3. Run: ./DHCPMonitor-*.AppImage

Linux Users

Option 1: AppImage (Recommended)

  1. Download DHCP Monitor Pro_1.1.37_amd64.AppImage
  2. Make executable: chmod +x DHCPMonitor-*.AppImage
  3. Run: ./DHCPMonitor-*.AppImage

Option 2: Source Build

# Install dependencies
sudo apt update
sudo apt install build-essential libssl-dev pkg-config libpcap-dev

# Clone and build
git clone https://github.com/iyotee/DHCPMonitor.git
cd DHCPMonitor
npm install
npm run tauri build

🛠️ Developer Installation

Prerequisites Installation

Node.js (v18+)

# Windows: Download from https://nodejs.org/
# macOS: Using Homebrew
brew install node

# Linux: Using package manager
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

Rust (v1.70+)

# All platforms
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env
rustup update

Git

# Windows: Download from https://git-scm.com/
# macOS: Using Homebrew
brew install git

# Linux: Using package manager
sudo apt install git  # Ubuntu/Debian
sudo yum install git  # CentOS/RHEL

Project Setup

1. Clone Repository

git clone https://github.com/iyotee/DHCPMonitor.git
cd DHCPMonitor

2. Install Dependencies

# Install Node.js dependencies
npm install

# Install Rust dependencies (automatic with cargo)
cargo build

3. Verify Installation

# Check Node.js
node --version
npm --version

# Check Rust
rustc --version
cargo --version

# Check Tauri CLI
npx @tauri-apps/cli --version

🔧 Platform-Specific Setup

Windows Development

Npcap SDK Installation

  1. Download Npcap SDK from npcap.com
  2. Extract to C:\Program Files\npcap-sdk-1.15\
  3. Set environment variables:
set LIB=C:\Program Files\npcap-sdk-1.15\Lib\x64;%LIB%
set INCLUDE=C:\Program Files\npcap-sdk-1.15\Include;%INCLUDE%

Visual Studio Build Tools

# Install Visual Studio Build Tools
# Download from: https://visualstudio.microsoft.com/downloads/
# Select: "C++ build tools" workload

Linux Development

Ubuntu/Debian

sudo apt update
sudo apt install build-essential libssl-dev pkg-config libpcap-dev
sudo apt install libgtk-3-dev libwebkit2gtk-4.0-dev libappindicator3-dev librsvg2-dev

CentOS/RHEL/Fedora

sudo yum groupinstall "Development Tools"
sudo yum install openssl-devel pkg-config libpcap-devel
sudo yum install gtk3-devel webkitgtk3-devel libappindicator-devel librsvg2-devel

Arch Linux

sudo pacman -S base-devel openssl pkg-config libpcap
sudo pacman -S gtk3 webkit2gtk libappindicator-gtk3 librsvg

macOS Development

Xcode Command Line Tools

xcode-select --install

Homebrew Dependencies

brew install pkg-config libpcap

🚨 Post-Installation

First Launch

  1. Run as Administrator/Root: Required for network capture
  2. Select Network Interface: Choose the interface to monitor
  3. Verify Permissions: Ensure firewall allows the application

Troubleshooting Common Issues

Permission Denied

# Windows: Right-click → "Run as administrator"
# Linux/macOS: Use sudo
sudo ./DHCPMonitor

No Network Interfaces Found

  • Check if running with elevated privileges
  • Verify network adapter is active
  • Check firewall settings

Build Errors

# Clean and rebuild
npm run clean
npm install
cargo clean
cargo build

📋 Verification Checklist

  • Application launches without errors
  • Network interfaces are detected
  • Can start packet capture
  • DHCP packets are captured
  • Interface responds to user input
  • Logs are displayed correctly

🔗 Next Steps

After successful installation:

  1. Read the Usage Guide
  2. Check Configuration for optimal settings
  3. Review Troubleshooting for common issues
  4. Join the Discussions

📚 Additional Resources

Clone this wiki locally