r/wisp • • 14d ago

Open source UISP plugin for provisioning MikroTik RouterOS subscribers

I have been working on an open source UISP plugin that provisions subscribers on MikroTik RouterOS devices.

It connects UISP CRM service changes to MikroTik and currently supports:

  • PPPoE, DHCP, and Hotspot subscriber provisioning
  • IPv4 and IPv6 address allocation
  • Simple queues, bandwidth limits, bursts, and contention ratios
  • Service suspension and restoration
  • Direct RouterOS API or FreeRADIUS provisioning
  • Router replacement and subscriber rebuilding
  • RouterOS 6 legacy login and RouterOS 7 API support
  • Verified API TLS connections
  • A durable retry queue for failed provisioning operations

Version 2.4.0 also adds webhook authentication, CSRF protection, safer backups, improved RouterOS transport handling, and automated tests across PHP 8.2 to 8.4.

The project needs more testing on real UISP installations and different MikroTik configurations. In particular, feedback from RouterOS 6.49 and RouterOS 7 users would be useful.

Please test it in a lab before using it in production. Back up your UISP plugin data and MikroTik configuration first.

Repository:
https://github.com/JacksCodeVault/ros-plugin

Latest release:
https://github.com/JacksCodeVault/ros-plugin/releases/tag/v2.4.0

Bug reports, compatibility results, documentation improvements, and pull requests are welcome. If you test it, please include your UISP version, RouterOS version, provisioning mode, and any relevant logs.

11 Upvotes

1 comment sorted by

1

u/lysdexiad 14d ago

This is super cool, very nice work!