Jesync Mikrowisp to LibreQoS Integration

⚠️ Notice: This integration script is currently in beta and has not yet been fully tested in a production Mikrowisp environment. We are actively looking for testers and contributors to help verify, improve, and harden this tool. If you're interested in helping validate this integration, please open an issue or contact us directly.

This Python script integrates Mikrowisp API with LibreQoS by syncing active users and bandwidth limits into ShapedDevices.csv.

🚀 Features

• Token-based Mikrowisp API v1.1 authentication
• Auto-generates LibreQoS-compatible CSV
• Syncs new users only, skipping duplicates
• Auto-reloads LibreQoS each cycle
• Configurable bandwidth defaults and plans

📦 Requirements

pip install requests

📥 Installation

---

🧪 One-Line Auto Installer (Ubuntu)

Want to install everything with one command? Run this:

bash <(curl -s https://raw.githubusercontent.com/jesienazareth/Jesync-Mikrowisp-Lqos-Integration/main/install.sh)

This will:

• Install dependencies
• Download the script to /opt/libreqos/src/jesync_dashboard/
• Automatically create and start a systemd service

Installation Option 2 (Manual)

Clone or Download

cd /opt/libreqos/src/
git clone https://github.com/YOUR_USERNAME/jesync-mikrowisp-libreqos.git

Create Required Folder

sudo mkdir -p /opt/libreqos/src/jesync_dashboard
sudo chown -R $USER:$USER /opt/libreqos/src/jesync_dashboard

Move Script

cp jesync_mikrowisp_Lqos_csv.py /opt/libreqos/src/jesync_dashboard/

Configure Script

Edit top variables like MIKROWISP_API_TOKEN, ALLOWED_PLANS, and SCAN_INTERVAL.

🧪 Manual Run

python3 /opt/libreqos/src/jesync_dashboard/jesync_mikrowisp_Lqos_csv.py

🔁 Auto Start

Cron

crontab -e

Add:

*/10 * * * * /usr/bin/python3 /opt/libreqos/src/jesync_dashboard/jesync_mikrowisp_Lqos_csv.py >> /var/log/jesync_mikrowisp.log 2>&1

Systemd

sudo nano /etc/systemd/system/jesync_mikrowisp.service

Paste:

[Unit]
Description=Jesync Mikrowisp Sync to LibreQoS
After=network.target

[Service]
ExecStart=/usr/bin/python3 /opt/libreqos/src/jesync_dashboard/jesync_mikrowisp_Lqos_csv.py
Restart=always
RestartSec=10
User=root

[Install]
WantedBy=multi-user.target

Then run:

sudo systemctl daemon-reexec
sudo systemctl enable jesync_mikrowisp
sudo systemctl start jesync_mikrowisp

💣 Uninstall

Remove systemd service:

sudo systemctl stop jesync_mikrowisp
sudo systemctl disable jesync_mikrowisp
sudo rm /etc/systemd/system/jesync_mikrowisp.service
sudo systemctl daemon-reexec

Remove files:

sudo rm /opt/libreqos/src/jesync_dashboard/jesync_mikrowisp_Lqos_csv.py
sudo rm /opt/libreqos/src/jesync_dashboard/ShapedDevices.csv
sudo rm -rf /opt/libreqos/src/jesync_dashboard/

Remove cron (if used):

crontab -e
# Delete any line referencing jesync_mikrowisp

---

Maintained by Jesync | JNHL IT Solutions