function Sidebar() { return ( ); }

NetStruct

NetStruct Logo

🧠 NetStruct: Visualize & Manage Your Network Topology 🕸️ Interactive Device Mapping, Drag & Drop Planning & Real-Time Infrastructure Design 📡

In today's complex IT environments, understanding and managing your network topology is crucial. Misplaced devices, undocumented connections, and lack of visibility can lead to performance issues, downtime, or even security risks.

NetStruct is a modern, interactive tool designed to help IT professionals visualize, plan, and manage network infrastructures. With real-time drag & drop capabilities, page-based layouts, and customizable markers, NetStruct makes network mapping intuitive and efficient.

NetStruct - Interactive Network Map with Device Markers and Background
NetStruct - Page Management for Multi-Site Network Layouts
NetStruct - Editable Marker Properties with Designation and Link
NetStruct - Real-Time Marker Placement and Drag & Drop Support
NetStruct - Background Image Upload and Scrolling Support
NetStruct - Marker Info Table with CSV Data Storage and Delete Option

🚀 Go to Dashboard

Explore the Dashboard of the NetStruct interactive network map and visualization tool.

🔗 Open NetStruct Demo

Why is NetStruct so powerful?

NetStruct is more than just a network visualization tool — it's a full-featured system for managing and monitoring your entire network infrastructure. With support for real-time status, visual planning, and flexible alarm integration, NetStruct helps you stay in control.

You can create and manage multiple pages for different environments or projects — like office floors, data centers, or separate networks.

For each device, alarms can be enabled or disabled with a single click. Every alarm belongs to a custom alarm category, which you can define and manage freely.

Even more powerful: for each alarm category, you can assign a dedicated API to trigger custom actions — from sending notifications to restarting systems or calling external services.

Key Features of NetStruct

  • 📌 Multi-Page Network Layout
    • Create and switch between different visual network pages easily.
    • Organize infrastructure by location, department, or function.
  • 🖼️ Interactive Network Mapping
    • Drag & drop routers, switches, firewalls, and more.
    • Custom icons, live status indication, and positioning.
  • 🚨 Flexible Alarm Management
    • Create multiple alarm categories with their own logic and purpose.
    • Individually enable/disable alarms for each device.
  • 🔗 API Trigger per Alarm Category
    • Assign custom APIs to each alarm category — triggered in real time.
    • Use it to send messages, integrate external systems, or automate recovery.
  • 📊 Real-Time Status Updates
    • Automatically check devices via ICMP ping or other methods.
    • Color-coded visual status: green = online, red = offline. ICMP Ping
  • 🧠 Intelligent Layout & UX
    • Hover effects, shadows, and clean design for professional use.
    • Tooltips, context menus, and searchable device selection.

How Does NetStruct Work?

  • Provides a modern, browser-based interface for planning and visualizing network topologies.
  • Lets you drag & drop devices like routers, switches, firewalls, and servers onto a scalable map.
  • Saves device positions, types, IPs, and categories in a structured CSV database — fully editable and persistent.
  • Supports real-time online/offline status checks via ICMP ping or API integration.
  • Draws dynamic connections between devices using visual lines with directional arrows (using LeaderLine).
  • Enables creation of multiple pages for different network zones or projects.
  • Allows adding custom alarm categories with activation toggles and linked API endpoints.
  • Each alarm event can trigger a unique API call, enabling automated notifications or external actions.
  • Includes built-in context menus for editing device info, alarm settings, and live data input.
  • Optimized for fast loading, responsive design, and modular extension — ideal for growing networks.
  • Use ICMP Ping.

Who Needs NetStruct?

  • 🔹 Network Engineers & IT Admins – Design and document complex infrastructures across multiple locations or departments.
  • 🔹 Data Center Operators – Organize racks, nodes, and backend systems on dynamic pages with clear visual mapping.
  • 🔹 Security Analysts – Define alarm categories and assign APIs to track anomalies or react to incidents in real-time.
  • 🔹 Enterprises & MSPs – Manage multiple clients or departments with separate network layouts and fully customizable monitoring.

Streamline and Monitor Your Infrastructure with NetStruct

NetStruct empowers you to create interactive network plans, track real-time device status, define alarm categories, and assign custom APIs for fast incident response. Whether you're overseeing an enterprise backbone, a datacenter layout, or a small office environment — NetStruct adapts to your infrastructure.

🛠 Build smarter networks, visualize device topology, and stay in full control – start using NetStruct today!

⚠️ Browser Compatibility Notice

Please note: NetStruct has been tested and optimized for Google Chrome and Microsoft Edge. It is known that certain functionalities (e.g., drag & drop) do not work properly in Firefox.

🖥️ Recommended Operating System

We recommend using Raspberry Pi Desktop for PC and Mac – a Debian-based operating system that provides the official Raspberry Pi OS desktop environment along with essential tools.

It is fully tested and works seamlessly with NetStruct. Ideal for:

  • 💻 Standard PCs and laptops
  • 📡 Dedicated or headless Linux servers
  • 📦 Virtual machines (e.g., VirtualBox, VMware, Proxmox)
  • 🧩 Raspberry Pi 3 / 4 / 5 boards

🐧 Alternatively, NetStruct is also compatible with other Linux-based systems such as:

  • 🔹 Debian (recommended)
  • 🔹 Ubuntu
  • 🔹 Raspberry Pi OS (Lite/Desktop)
  • 🔹 Any Linux server or VM with Python and basic system tools installed

💡 Whether you're deploying NetStruct on a small Raspberry Pi or in a large virtualized server environment — it adapts to your setup.

🐧 Other Supported Systems

NetStruct also runs on other modern Linux distributions like Debian, Ubuntu, or Raspberry Pi OS (Lite or Desktop).

💡 You can install it on:

  • 🧩 Raspberry Pi 3, 4, 5
  • 💻 Linux PCs or Laptops
  • 📡 Dedicated Servers
  • 💾 Virtual Machines (e.g., VirtualBox, VMware, Proxmox)
🐳 Prefer containers? NetStruct is also available as a ready-to-use Docker container.
👉 Pull the image with: 
docker pull itfourall/netstruct
🐳 Run container:
docker run -d -p 8080:80 --name netstruct itfourall/netstruct
🔗 View it on Docker Hub
💡 Ideal for fast deployment on any system that supports Docker – no manual setup required!

For advanced users, a manual installation script is also available. (See below)

📎 Recommended OS: Raspberry Pi Desktop for PC and Mac
💡 Based on Debian, this OS includes the full Raspberry Pi Desktop and official tools. It is perfect for use on physical hardware, servers or inside virtual machines.

⚙️ Installation with Auto-Installer (Recommended)

Install NetStruct quickly using our auto-installer script.

  • 📥 First, install a compatible Linux system (e.g. Raspberry Pi Desktop for PC and Mac, Raspberry Pi OS, Debian, Ubuntu...)
  • 💡 Note: The recommended OS already includes the sudo package by default.
  • 🔧 If you're using a different distribution, make sure sudo is installed before running any commands. How to install it? Click here.
  • 🖥️ Open the terminal or connect via SSH (e.g. with PuTTY).
  • ⌨️ Now enter the following commands one by one:

You need root rights!!!

How to install it "sudo"? Click here.

apt install sudo -y
sudo apt install wget -y
sudo wget -O - https://raw.githubusercontent.com/IT-4-ALL/NetStruct/main/netstruct.sh | sed 's/\r$//' | bash

📎 Tip: If you're unsure which OS to use, we recommend Raspberry Pi Desktop for PC and Mac – it's based on Debian, lightweight, and works perfectly with NetStruct on laptops, servers, or VMs.

📄 View official OS documentation and image download: Raspberry Pi OS Release Notes

🌐 Accessing the Web Interface

Once the installation is complete, restart your Raspberry Pi and open a web browser on your computer or mobile device.

💡 Note: This step is the same whether you installed BroadcastDetector manually or used the pre-configured image.

In the address bar, type:

http://[IP Address]/drag/index.php

To find your IP address, use one of the following commands in the terminal:

hostname -I

or

ifconfig

or

ip a

Look for the IP address under the wlan0 or eth0 section.

Once entered, press Enter and you will be redirected to the NetStruct web interface.