routeros-user-manager
User Manager on MikroTik RouterOS 7, the built-in RADIUS server and user database. Covers enabling it and its package and licence limits, registering routers (NAS devices) with shared secrets and RadSec, users and groups, allowed outer and inner authentication methods (PAP, CHAP, MS-CHAP, EAP-TLS, TTLS, PEAP), profiles with limitations (rate, traffic, uptime, time windows), assigning profiles to users, RADIUS attributes (static IP, address pool, rate limit), sessions and accounting, vouchers and batch users, TOTP, the /um web interface and PayPal payments, and migration from RouterOS 6. Use when a RouterOS device should act as the RADIUS server for HotSpot, PPP, wireless 802.1X or DHCP, or when selling or limiting access by time and volume.
How do I install this agent skill?
npx skills add https://github.com/wiresage/routeros-skills --skill routeros-user-managerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive documentation and configuration examples for the MikroTik RouterOS User Manager. It includes details on RADIUS server setup, user management, profile limitations, and payment integration. No security issues were detected; the skill uses best practices like placeholders for sensitive credentials and includes warnings about data privacy.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
RouterOS User Manager
User Manager (UM) is a RADIUS server (UDP 1812 authentication, 1813 accounting) with its own database, a per-user web page at /um/, profiles,
limitations and optional PayPal sales. It is a separate package (user-manager), available on all architectures except SMIPS, and the licence level
limits the number of active sessions. The router that runs UM is the RADIUS server; the routers that authenticate users against it are
its clients (NAS), configured with /radius (routeros-users-aaa).
Quick start
/user-manager/set enabled=yes
/user-manager/router/add name=local address=127.0.0.1 shared-secret="REPLACE-ME" # the router itself as NAS
/user-manager/user/add name=alice password="REPLACE-ME" shared-users=1
/radius/add service=hotspot address=127.0.0.1 secret="REPLACE-ME" # client side, on the NAS
- Add every NAS under
/user-manager/router(address,shared-secret,coa-portdefault 3799,protocol=udp|radsec) with the same secret as on the NAS client entry. A NAS that is not registered gets no answers. Run/user-manager/set enabled=yesand allow UDP 1812 and 1813 from the NAS addresses. - On the NAS, set the service to use RADIUS:
use-radius=yesin the HotSpot profile (routeros-hotspot), the PPP profile or secrets (routeros-vpn), or the RADIUS option of the wireless/802.1X configuration (routeros-wireless). Enable RADIUS accounting and interim updates if limits or session disconnects matter. - With
use-profiles=no(default) only users are needed. Turnuse-profiles=yesto enforce profiles and limitations. - Settings:
authentication-port1812,accounting-port1813,certificatefor EAP-TLS methods,radsec-certificatefor RadSec. - The database is separate from the router configuration and from
/export/backups:/user-manager/database/save name=backupandloadhandle.umbfiles;db-pathcan point to external storage.
Users and groups
/user-manager/user/group/add name=staff outer-auths=pap,chap,mschap2,eap-peap inner-auths=peap-mschap2 attributes=Framed-Pool:pool1
/user-manager/user/add name=bob password="REPLACE-ME" group=staff shared-users=2
/user-manager/user/set [find name=carol] attributes=Framed-IP-Address:192.168.1.4 shared-users=1
/user-manager/user/add-batch-users number-of-users=3 password-characters=lowercase,numbers,uppercase password-length=6 username-characters=lowercase username-length=6
- Groups
defaultanddefault-anonymousexist. A group lists allowedouter-auths(pap,chap,mschap1,mschap2,eap-tls,eap-ttls,eap-peap,eap-mschap2) andinner-auths(ttls-pap,ttls-chap,ttls-mschap1,ttls-mschap2,peap-mschap2) plus RADIUS attributes. A method that is not listed is refused. Framed-IP-Addressneedsshared-users=1.Framed-Poolnames a pool that must exist on the NAS. Other predefined attributes includeMikrotik-Rate-Limit,Mikrotik-Group(HotSpot or PPP profile),Mikrotik-Address-List,Mikrotik-Wireless-VLANID,Session-Timeout,Idle-Timeout; custom attributes go in/user-manager/attribute(vendor id, type id, value type).caller-idrestricts a user to oneCalling-Station-Id. TOTP: setotp-secretand append the current 6-digit code to the password (the clock must be right).- Vouchers:
generate-voucher voucher-template=printable_vouchers.html [find where name=alice]writes under/um/PRIVATE/GENERATED/vouchers/(setweb-private-usernameandweb-private-passwordin/user-manager/advancedto open it);export.csvorexport.xmlexports all users. Reports:/user-manager/generate-report report-template=report_default.html columns=username,uptime,download,upload.
Profiles and limitations
/user-manager/limitation/add name=lim-5m download-limit=0 upload-limit=0 transfer-limit=10000000000 uptime-limit=30d \
rate-limit-rx=2M rate-limit-tx=10M reset-counters-interval=monthly
/user-manager/profile/add name=monthly validity=30d starts-when=first-auth name-for-users="Monthly" price=10
/user-manager/profile-limitation/add profile=monthly limitation=lim-5m from-time=00:00:00 till-time=23:59:59
/user-manager/user-profile/add user=alice profile=monthly
- A limitation holds limits:
download-limit,upload-limit,transfer-limit(bytes, 0 is unlimited),uptime-limit, rate limit parts (rate-limit-rx,rate-limit-tx, burst fields) and periodic counter resets. A profile hasvalidity,starts-when(assignedorfirst-auth),price,override-shared-users. profile-limitation links them withfrom-time,till-timeandweekdays; when a profile has several limitations the user must satisfy all of them. - A user can hold several user-profile entries; only one is active, and the next takes over when it expires, without dropping the session.
activate-user-profileforces one. - Limits and disconnects need RADIUS accounting and interim updates on the NAS, and
/radius/incoming/set accept=yeson the NAS so UM can disconnect active sessions (portcoa-portof the router entry, default 3799). When a shared-users limit is reached the older session is disconnected first, so use/radiustimeout=1sin such setups. IPsec does not support rate limitations. - Sessions:
/user-manager/session/print(only recorded when the NAS sends accounting), per-usermonitor.
Web interface and payments
Users sign in at http://<router>/um/ (served by the www/www-ssl services; assign a certificate for HTTPS) to see sessions, profiles and, when a profile has a price, buy it with PayPal
(paypal-allow=yes, paypal-user, paypal-password, paypal-signature, paypal-currency, paypal-use-sandbox for testing in
/user-manager/advanced). Only transactions with status approved are complete. Login pages and CSS can be replaced (css/, user/login_dynamic.html, and others
listed in the guide). Restrict /um/ to the networks that need it in /ip/service and the firewall.
Migration and cautions
- After moving from RouterOS 6, UM 7 starts empty. Copy the old files and run
/user-manager/database/migrate-legacy-db; it converts users, profiles, limitations, routers and sessions. - Secrets, passwords and PayPal credentials are sensitive; do not publish exports. A weak
shared-secretlets anyone who can reach UDP 1812 forge a NAS. - Check UM is reachable before blaming the service: log topics
managerandradius(routeros-diagnostics-monitoring).
Where to look
| Need | Open |
|---|---|
| Attributes table, database, limitations, profiles, routers, sessions, settings, users, groups, web interface, application guides | references/guides/authentication-authorization-accounting/user-manager.md |
| Properties | references/cli/user-manager.md and the sub-menus references/cli/user-manager/ (router, user, user/group, limitation, profile, profile-limitation, user-profile, session, payment, attribute, database, advanced) |
| Everything else | references/INDEX.md |
Related skills: routeros-hotspot, routeros-users-aaa (RADIUS client, 802.1X, PPP accounts), routeros-vpn (PPP with RADIUS), routeros-wireless (WPA-EAP),
routeros-certificates (EAP-TLS, RadSec), routeros-queues, routeros-install-upgrade (packages and licence).
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/wiresage/routeros-skills/routeros-user-manager">View routeros-user-manager on skillZs</a>