Skip to content

tosumitdhaka/trishul-snmp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

158 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

πŸ”± Trishul-SNMP

Modern SNMP Management Platform

GitHub Stars GitHub Forks GitHub Issues License GHCR

A web-based SNMP toolkit for network engineers and administrators. Simulate SNMP agents, send/receive traps, walk devices with MIB resolution, browse MIB trees, and manage MIB filesβ€”all from a clean, intuitive interface.

Replace 5+ SNMP tools with one modern platform


Trishul SNMP Studio Demo


✨ Features

  • πŸ–₯️ SNMP Simulator - Run configurable SNMP agent with custom OID values
  • 🚢 Walk & Parse - Execute SNMP walks with MIB resolution, export to JSON/CSV
  • πŸ“‘ Trap Manager - Send/receive SNMP traps with real-time monitoring
  • πŸ“š MIB Manager - Upload, validate MIBs, browse trap library, auto-resolve OIDs with dependency detection
  • 🌳 MIB Browser - Interactive tree explorer with hierarchical OID navigation, search, and filtering
  • πŸ” Secure - Session-based authentication with credential management
  • 🐳 Containerized - One-command Docker deployment with host network support
  • 🌐 Modern UI - Clean, responsive interface built with Bootstrap 5
  • πŸ“Š Export Data - JSON/CSV export for walks and trap data
  • πŸ”„ Real-time - Live trap receiver with instant OID resolution
  • ⚑ WebSocket Push - Live status and stats updates via WS β€” zero polling
  • πŸ“Š Activity Stats - Dashboard counters for SNMP requests, traps, walks, MIB reloads β€” all real-time

🎯 What Trishul-SNMP Replaces

Tool Cost Trishul-SNMP
Net-SNMP CLI tools Free βœ… Web UI with no command memorization
snmpsim Free βœ… Test SNMP agent responses with web interface
iReasoning MIB Browser $500+ βœ… Free MIB browser with tree navigation
snmptrapd Free βœ… Real-time trap receiver for testing
Custom scripts Time βœ… Built-in JSON/CSV export functionality
Multiple scattered tools Complexity βœ… One unified platform

Save $500+ and consolidate your SNMP workflow.


πŸš€ Quick Start

One-Command Install

curl -fsSL https://raw.githubusercontent.com/tosumitdhaka/trishul-snmp/main/install-trishul-snmp.sh | bash

Access

⚠️ Change password immediately in Settings!

Custom Ports

BACKEND_PORT=9000 FRONTEND_PORT=3000 ./install-trishul-snmp.sh up

πŸ“– Detailed Installation Guide β†’


🧩 Component Overview

πŸ–₯️ SNMP Simulator (Server Mode)

Run a configurable SNMP agent on UDP 1061 with custom OID values. Perfect for testing SNMP clients without real hardware.

Key features:

  • Custom OIDs with any value and type
  • SNMPv1/v2c support
  • Persistent configuration
  • Web-based control

Use case: Simulate devices for NMS development and testing.

πŸ“– Full Simulator Guide β†’


🚢 Walk & Parse (Client Mode)

Execute SNMP walks against any device with automatic MIB resolution and data export.

Key features:

  • Automatic OID β†’ name resolution
  • Bulk operations (GETBULK)
  • JSON/CSV export
  • Walk history

Use case: Test SNMP agent responses, validate walk implementations.

πŸ“– Full Walker Guide β†’


πŸ“‘ Trap Manager (Client + Server)

Send and receive SNMP traps with real-time monitoring and MIB-based trap browsing.

Key features:

  • Trap Sender (Client): Send v1/v2c traps with custom varbinds
  • Trap Receiver (Server): Real-time trap display on UDP 1162
  • Trap Library: Browse 24+ available traps from loaded MIBs
  • Auto-populate varbinds from library

Use case: Validate trap format/syntax for NMS development.

πŸ“– Full Trap Manager Guide β†’


πŸ“š MIB Manager

Upload, validate, and manage MIB files with automatic dependency resolution.

Key features:

  • Drag-and-drop upload
  • Syntax validation
  • Dependency resolution
  • Trap enumeration
  • Statistics (objects, imports, traps)

Use case: Validate MIBs before deployment, centralized MIB library.

πŸ“– Full MIB Manager Guide β†’


🌳 MIB Browser

Interactive tree explorer for navigating OID hierarchies and understanding MIB structures.

Key features:

  • Dual views: By module or standard OID hierarchy
  • Real-time search: Find OIDs by name, numeric OID, or description
  • Smart filtering: By module and type (scalars, tables, notifications)
  • Tree navigation: Expandable with configurable depth (1-5 levels)
  • Details panel: Full metadata, descriptions, varbinds
  • Integration: Jump to Walker/Trap Sender with pre-filled data
  • State persistence: Remembers your position

Use case: Explore MIB structures, understand OID relationships, find traps.

πŸ“– Full MIB Browser Guide β†’


πŸ” Settings

Manage authentication and system preferences.

Key features:

  • Credential management (username + password with strength indicator)
  • Auto-start toggles and session timeout (persisted to app_settings.json)
  • Export or reset activity stats
  • System info (version, author, description)

πŸ—οΈ Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚           Web Browser (Port 8080)                 β”‚
β”‚  Dashboard β”‚ Simulator β”‚ Walker β”‚ Traps β”‚ MIB    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                      β”‚ HTTP / WebSocket
                      β”‚
         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”
         β”‚   Nginx (Frontend)      β”‚
         β”‚   Static Files + Proxy  β”‚
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                      β”‚ REST API + WebSocket
                      β”‚
         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
         β”‚   FastAPI Backend (Port 8000)        β”‚
         β”‚                                      β”‚
         β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
         β”‚  β”‚  MIB Service                   β”‚  β”‚
         β”‚  β”‚  β€’ Parse & validate MIBs       β”‚  β”‚
         β”‚  β”‚  β€’ Build OID trees             β”‚  β”‚
         β”‚  β”‚  β€’ Search & filter             β”‚  β”‚
         β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
         β”‚                                      β”‚
         β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
         β”‚  β”‚  SNMP Services                 β”‚  β”‚
         β”‚  β”‚  β€’ Simulator (SVR - UDP 1061)  β”‚  β”‚
         β”‚  β”‚  β€’ Trap Sender (CLI)           β”‚  β”‚
         β”‚  β”‚  β€’ Trap Receiver (SVR - 1162)  β”‚  β”‚
         β”‚  β”‚  β€’ Walker (CLI)                β”‚  β”‚
         β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
         β”‚                                      β”‚
         β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
         β”‚  β”‚  Data Storage (Volume)         β”‚  β”‚
         β”‚  β”‚  /app/data/mibs/               β”‚  β”‚
         β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                        β”‚ SNMP (UDP)
                        β”‚
         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
         β”‚                             β”‚
    β”Œβ”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”               β”Œβ”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”
    β”‚  Test    β”‚               β”‚   Test     β”‚
    β”‚ Devices  β”‚               β”‚  Receivers β”‚
    β”‚(Dev/Test)β”‚               β”‚ (Dev/Test) β”‚
    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜               β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Stack: Python 3.11 β€’ FastAPI β€’ pysnmp β€’ pysmi β€’ Bootstrap 5 β€’ Docker

πŸ“– Detailed Architecture β†’


🎯 Use Cases

For NMS Development

  • βœ… Send test traps to validate receiver format/syntax
  • βœ… Receive test traps to validate sender implementation
  • βœ… Simulate SNMP agents for client testing
  • βœ… Test SNMP walk responses

For MIB Management

  • βœ… Validate MIB syntax and dependencies
  • βœ… Explore MIB structures interactively
  • βœ… Search OIDs across multiple MIBs
  • βœ… Resolve OID names ↔ numeric OIDs

For Integration Testing

  • βœ… Test SNMP integrations without production devices
  • βœ… Validate trap handling in dev environments
  • βœ… Simulate device responses for QA
  • βœ… Export walk data for automated testing

For Learning & Training

  • βœ… Understand SNMP protocol behavior
  • βœ… Explore standard MIB structures
  • βœ… Practice SNMP operations safely
  • βœ… Learn OID hierarchies visually

πŸ“– More Use Cases & Examples β†’


πŸ‘₯ Best For

  • πŸ”§ Network engineers testing devices and exploring MIB structures
  • πŸš€ DevOps teams testing SNMP integrations
  • πŸ“š Students learning SNMP protocols and MIB hierarchies
  • βœ… QA teams validating SNMP implementations
  • πŸ‘₯ Small teams needing trap monitoring and MIB browsing
  • πŸ§ͺ Developers building SNMP-enabled applications

⚠️ Not For

  • ❌ Production 24/7 monitoring (use Zabbix, PRTG, LibreNMS)
  • ❌ Enterprise-scale NMS (use SolarWinds, Cisco Prime)
  • ❌ High-availability monitoring (use dedicated monitoring platforms)

πŸ“š Documentation

Complete guides available in Wiki:

Getting Started

User Guides

Technical


πŸ“° Featured Article

Dev.to Article

A technical deep dive into building a free, open-source alternative to $500 commercial tools.

Read about:

  • πŸ—οΈ Architecture decisions - Why FastAPI, pysnmp, and Docker host network mode
  • πŸ”§ Technical challenges - MIB parsing, state persistence, performance optimization
  • πŸ’‘ Solutions implemented - Caching strategies, lazy loading, image optimization
  • πŸ“Š Lessons learned - 8 months of development insights
  • 🎯 Results - 150+ stars, 500+ pulls, 3 companies in production

🀝 Contributing

We welcome contributions! πŸŽ‰

Contributors

Ways to contribute:

See CONTRIBUTING.md and Development Setup for details.


πŸ’Ά Support This Project

Trishul-SNMP is 100% free and open-source (MIT License).

If it helps you:

GitHub Sponsors Buy Me A Coffee


πŸš€ Roadmap

βœ… v1.2.5 (Current)

  • Dark mode implementation (persisted to local storage)
  • Drag-and-drop MIB file uploads
  • Auto-validation on MIB file selection
  • WebSocket real-time push (dashboard, simulator, traps)
  • Activity stats dashboard (8 live counters)
  • App behaviour settings (auto-start, session timeout)
  • Stats export / reset from Settings page

πŸ“‹ v1.3.0 (Planned)

  • Auto-fetch missing MIB dependencies from remote repositories
  • SNMPv3 authentication (MD5, SHA, AES)
  • Tree export to JSON/CSV

πŸ“‹ v1.2.4

  • WebSocket real-time push (dashboard, simulator, traps)
  • Activity stats dashboard (8 live counters)
  • App behaviour settings (auto-start, session timeout)
  • Stats export / reset from Settings page

πŸ“‹ Planned (Future)

  • Scheduled SNMP walks
  • Device/Agent management
  • Multi-language support

Vote on features β†’


πŸ“Š Project Stats

GitHub commit activity GitHub last commit GitHub code size


Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Recognition

All contributors are recognized in CONTRIBUTORS.md and release notes! 🌟


πŸ“„ License

MIT License - See LICENSE file for details.

Free forever. No hidden costs. No feature paywalls.


πŸ“ž Community & Support


πŸ™ Acknowledgments

Built with:


Star This Repo

If trishul-snmp helps you β€” leave mass star. ⭐

Star History Chart


Made with πŸ”± by Sumit Dhaka

Trishul-SNMP - Modern SNMP Management Made Simple

If this project helps you, please consider ⭐ starring it and πŸ’° sponsoring!

GitHub LinkedIn

⬆ Back to Top

About

πŸ”± Modern SNMP management platform - Simulate agents, walk devices, manage traps, browse MIBs. Replace Net-SNMP CLI, iReasoning, snmpsim with one web-based tool. Docker β€’ FastAPI β€’ Python

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

 
 
 

Contributors