Simple SNMP Daemon

A lightweight, secure, and cross-platform SNMP daemon built with modern C++.

Features

• Lightweight: Minimal resource footprint with efficient memory usage
• Secure: Built with security best practices and comprehensive access controls
• Cross-platform: Runs on Linux, macOS, and Windows
• Modern C++: Built with C++17 and modern development practices
• Complete SNMP Support: Full SNMP v1, v2c, and v3 protocol implementation
• Advanced MIB Support: System, Interface, and SNMP MIBs with custom MIB support
• Enterprise Security: User-based Security Model (USM), View-based Access Control (VACM)
• Performance Optimized: Multi-threading, memory pools, and high-performance networking
• Monitoring Ready: Prometheus metrics, health checks, and comprehensive observability
• Docker Ready: Multi-architecture containerized deployment
• CI/CD Ready: Complete Jenkins pipeline with automated testing and deployment
• Production Ready: Comprehensive logging, monitoring, and deployment options

Quick Start

Installation

From Source

# Clone the repository
git clone https://github.com/simpledaemons/simple-snmpd.git
cd simple-snmpd

# Build the project
make

# Install (requires sudo on Unix systems)
make install

Using Docker

# Pull the Docker image
docker pull simpledaemons/simple-snmpd:latest

# Run the container
docker run -d --name simple-snmpd \
  -p 161:161/udp \
  -v /path/to/config:/etc/simple-snmpd \
  simpledaemons/simple-snmpd:latest

Basic Usage

# Start with default configuration
sudo simple-snmpd

# Start with custom config
sudo simple-snmpd -c /path/to/config.conf

# Test configuration
simple-snmpd --test-config -c /etc/simple-snmpd/simple-snmpd.conf

Test SNMP Queries

# Test with snmpget (if available)
snmpget -v2c -c public localhost 1.3.6.1.2.1.1.1.0

# Test with snmpwalk (if available)
snmpwalk -v2c -c public localhost

Configuration

Edit /etc/simple-snmpd/simple-snmpd.conf:

# Network Configuration
port=161
enable_ipv6=true

# Community Configuration
community=public

# Connection Limits
max_connections=100
timeout_seconds=30

# Logging Configuration
log_level=info

# Trap Configuration
enable_trap=false
trap_port=162

See the Configuration Guide for detailed options.

Building

Prerequisites

• C++17 compatible compiler (GCC 7+, Clang 5+, MSVC 2017+)
• CMake 3.16 or later
• Git

Build Commands

# Basic build
make

# Build with tests
make test

# Build packages
make package

# Clean build
make clean

Platform-Specific Builds

Linux

# Use the Linux build script
./scripts/build/build-linux.sh

# Build with packages
./scripts/build/build-linux.sh --package

macOS

# Use the macOS build script
./scripts/build/build-macos.sh

# Build universal binary
ARCHITECTURES="x86_64;arm64" ./scripts/build/build-macos.sh

Docker

# Build multi-platform Docker image
./scripts/build-docker.sh

# Build for specific platform
./scripts/build-docker.sh single linux/amd64

Deployment

System Service

Linux (systemd)

# Enable and start the service
sudo systemctl enable simple-snmpd
sudo systemctl start simple-snmpd

# Check status
sudo systemctl status simple-snmpd

macOS (launchd)

# Copy the plist file
sudo cp deployment/launchd/com.simpledaemons.simple-snmpd.plist /Library/LaunchDaemons/

# Load and start the service
sudo launchctl load /Library/LaunchDaemons/com.simpledaemons.simple-snmpd.plist

Windows

# Install as Windows service
sc create "Simple SNMP Daemon" binPath="C:\Program Files\simple-snmpd\simple-snmpd.exe" start=auto
sc start "Simple SNMP Daemon"

Docker Deployment

# Deploy using the deployment script
./scripts/deploy-docker.sh deploy

# Check status
./scripts/deploy-docker.sh status

# View logs
./scripts/deploy-docker.sh logs

Architecture

simple-snmpd/
├── src/                    # Source code
│   ├── main.cpp           # Application entry point
│   └── core/              # Core SNMP implementation
│       ├── snmp_server.cpp    # SNMP server
│       ├── snmp_packet.cpp    # Packet handling
│       ├── snmp_config.cpp    # Configuration
│       ├── logger.cpp         # Logging system
│       └── platform.cpp       # Platform abstraction
├── include/               # Header files
│   └── simple_snmpd/     # Public API headers
├── config/               # Configuration files
├── deployment/           # Service configurations
├── docs/                 # Documentation
├── scripts/              # Build and deployment scripts
└── tests/                # Test suite

Development

Project Structure

The project follows a modular architecture with clear separation of concerns:

• Core: SNMP protocol implementation and server logic
• Platform: Cross-platform abstraction layer
• Configuration: Flexible configuration management
• Logging: Comprehensive logging and error handling
• Deployment: Multi-platform service configurations

Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

Development Setup

# Clone and setup development environment
git clone https://github.com/simpledaemons/simple-snmpd.git
cd simple-snmpd

# Install development dependencies
make dev-deps

# Build in debug mode
make dev-build

# Run tests
make test

Roadmap

See ROADMAP.md for the complete development roadmap.

Current Version (v0.3.0) - Phase 3 Complete

• ✅ Phase 1: Core SNMP daemon implementation
• ✅ Phase 2: Complete SNMP protocol support (v1, v2c, MIBs, security)
• ✅ Phase 3: Advanced features (SNMP v3, performance, monitoring)
• ✅ Cross-platform build system
• ✅ Docker containerization with multi-architecture support
• ✅ Service configurations for all platforms
• ✅ Comprehensive testing suite
• ✅ CI/CD pipeline with Jenkins

Upcoming Features (Phase 4 & 5)

• 🔄 Phase 4: Enterprise features (web UI, REST API, advanced MIBs)
• 🔄 Phase 5: Cloud and container features (Kubernetes, Helm charts)
• 🔄 Dynamic MIB loading and compilation
• 🔄 Web-based management interface
• 🔄 Kubernetes operator and Helm charts

Documentation

• Installation Guide
• Quick Start Guide
• Configuration Guide
• Deployment Guide
• User Guide
• CI/CD Pipeline
• Changelog
• Troubleshooting

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: Project Documentation

License

Copyright 2024 SimpleDaemons

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Acknowledgments

• Built with modern C++ and cross-platform best practices
• Inspired by the need for lightweight, secure SNMP implementations
• Community-driven development and feedback

---

Simple SNMP Daemon - Making SNMP monitoring simple, secure, and reliable.