PlcTcpToolbox

PlcTcpToolbox is a specialized utility suite designed to bridge the gap between Industrial PLCs (Programmable Logic Controllers) and modern IT infrastructure. It provides centralized logging, file storage, status monitoring, and automated backups for Siemens S7 and other TCP-capable controllers.

🚀 Key Features

• Centralized TCP Dispatcher: A single entry point for all PLC communication, routing traffic based on a custom, lightweight protocol.
• Message Server: Real-time logging of PLC events with categorization (Alarm, Warning, Info) and instant notifications.
• File Server: Store and append data from PLCs directly into structured files (CSV, Logs, etc.) via TCP.
• Status Server: Live dashboard for monitoring the online status of multiple field devices.
• Siemens S7 Backup: Enterprise-ready backup solution for Siemens PLCs using the WebAPI (S7-1200 / S7-1500).
  • Remote variable browsing
  • Scheduled backups (Daily/Weekly)
  • Backup Retention: Automatically keep only the latest N versions per datablock.
• Alerting Engine: Integrated support for Telegram Bots and Email (SMTP) with per-device configuration and hourly schedules.

🛠️ Quick Start (Docker)

The fastest way to run PlcTcpToolbox is via Docker Compose:

version: '3.8'
services:
  plctcptoolbox:
    image: git.eisenreichandreas.de/andreas/plctcptoolbox:latest
    container_name: plctcptoolbox
    network_mode: host
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Right now it is recommended to use network_mode: host, because the configured devices are identified by their IP address. For this reason the container have to run in a Linux enviroment. Docker Desktop on Windows does not support network_mode: host.

1. Access the UI at http://localhost:8080. (or the IP address of the host)
2. Configure your TCP port and notification settings in the Configuration menu.
3. Download the provided SCL Blocks to integrate your PLC code.

📖 Documentation

Dive deeper into specific modules:

• User Manual: How to use the Web UI to monitor and manage your plant.
• Technical Reference: Routing syntax, TCP protocols, and PLC integration (SCL).
• Telegram Structure: Detailed breakdown of TCP message formats for all modules.
• Configuration Guide: Setting up Notifications, IP Filtering, and Backups.

⚖️ License

Copyright © 2026 Eisenreich Andreas. All rights reserved. Commercial use requires a valid license key.