szomorxvigyor/firmware-webmanager repository overview

⁠🔧 A Simple Firmware Management Server

⁠A lightweight, containerized firmware management system with REST API and web UI — designed for managing OTA updates across diverse hardware like IoT devices, microcontrollers, and embedded systems.

⁠📦 Features

• ✅ REST API + Admin Web UI
• 🔐 JWT-protected firmware uploads
• 📱 Multi-device + semantic versioning
• 💾 Storage: FileSystem (default) or MongoDB GridFS
• ⚙️ Dockerized with health checks & non-root user

⁠🚀 Quick Start (FileSystem)

docker run -d \
  --name firmware-server \
  -p 3000:3000 \
  -e STORAGE_TYPE=filesystem \
  -v $PWD/data:/app/data \
  szomorxvigyor/firmware-webmanager

Then visit: http://localhost:3000⁠ Default credentials: admin / admin123

⁠🛠️ Using MongoDB

docker run -d \
  --name firmware-server \
  -p 3000:3000 \
  -e STORAGE_TYPE=mongodb \
  -e MONGODB_URI=mongodb://host.docker.internal:27017 \
  szomorxvigyor/firmware-webmanager

⁠🔗 API Highlights

GET    /api/firmwares              # List firmwares
GET    /api/firmwares?device=ESP32 # Filter by device
POST   /api/login                  # Get JWT token
POST   /api/firmware/upload        # Upload firmware (auth)
GET    /api/firmware/{id}/download # Download binary

📚 Complete API Documentation⁠

⁠📁 Volumes (filesystem mode)

⁠🔐 Security Tips

• Change the default password
• Use HTTPS in production
• Monitor disk usage
• Enable firewalls

⁠🧪 Health Check

This container includes a built-in HTTP health check on /api/health.

⁠🤝 Contribute

Want to improve or add features? Visit the GitHub Repo⁠

⁠📝 License

MIT © SzomorXVigyor⁠