ewelink/sonoff-dongle-flasher repository overview

⁠SONOFF Dongle Flasher

⁠Overview

SONOFF Dongle Flasher provides a web-based firmware flashing service for the following devices:

• ZBDongle-P
• ZBDongle-E
• Dongle-M⁠
• Dongle-PMG24⁠
• Dongle-LMG21⁠
• Dongle-PZG23⁠
• Dongle-MZG23⁠

This container is derived from the iHost Open Source Project Dongle Flasher Add-on⁠, providing the same online firmware flashing capability.

⁠Supported Architectures

⁠Notes

1. Data Directory (Required)

   • The application reads from and writes persistent data to /workspace/data inside the container.

   • Recommended mount:

     -v $(pwd)/data:/workspace/data
     

     Copy

2. Serial Discovery (Optional)

   • Mount /run/udev to enable automatic Dongle detection.
   • If not mounted, you can manually select the serial port from the web interface.

⁠Example Run (CLI)

docker run  --name sonoff-dongle-flasher  -d  -p 8324:8324  --privileged  -v $(pwd)/data:/workspace/data  -v /run/udev:/run/udev:ro  ewelink/sonoff-dongle-flasher:latest

Parameters

• --name sonoff-dongle-flasher: Container name.
• -d: Run in background.
• -p 8324:8324: Expose the web console port.
• --privileged: Grant access to hardware interfaces.
• -v $(pwd)/data:/workspace/data: Mount a local folder for configuration and persistent data.
• -v /run/udev:/run/udev:ro (optional): Enable automatic Dongle detection.
• ewelink/sonoff-dongle-flasher:latest

⁠Deploy via Portainer (Stack)

⁠Option: Auto-discovery (mount /run/udev only)

version: "3.8"

services:
  sonoff-dongle-flasher:
    image: ewelink/sonoff-dongle-flasher:latest
    container_name: sonoff-dongle-flasher
    ports:
      - "8324:8324"            # Web console
    privileged: true
    volumes:
      - sonoff_data:/workspace/data  # Persistent config/firmware
      - /run/udev:/run/udev:ro       # Auto-discovery
    restart: unless-stopped

volumes:
  sonoff_data:

⁠Docker Hub

Repository: https://hub.docker.com/r/ewelink/sonoff-dongle-flasher⁠

⁠Maintainer

Maintainer: eWeLink Developer

⁠Feedback

Github issues⁠