routeros-tuipreview

Cross-platform terminal for MikroTik RouterOS

RouterOS management, without leaving the keyboard.

A keyboard-first application for managing RouterOS devices from Linux, macOS, and Windows. Open several routers in tabs, each with its own live session. Built for operators who outgrow WebFig and WinBox because neither is designed around the keyboard.

Simulated RouterOS TUI session with several device tabs, showing live interface traffic on a CCR2004.
routeros-tuiCCR2004 · 192.0.2.1CPU 18%MEM 41%WAN 84.2 Mb/s
NameTypeStatusRx
ether1etherrunning84.2 Mb/s
ether2etherrunning1.1 Mb/s
wg0wgrunning412 Kb/s
vlan10vlanrunning96 Kb/s
bridge1bridgerunning85.8 Mb/s
↑↓ moveenter edit/ filtert torch? helpq quit

This project is new. Expect bugs and unstable behavior. Needs RouterOS 7.18 or newer.

The menus you already type, as a live table.

Interfaces, WireGuard, PPP, Bridge, Switch, IP, IPv6, Routing, Queues, Files, Tools, RADIUS, and System share the same create/edit/delete catalog, with a confirmation first. Torch and counters sit on interface tables. Keep more than one device open; each tab holds its own connection. Secrets stay masked; runtime views such as logs remain inspect-only. A dropped tab shows LINK DOWN and blocks writes until it reconnects. A read-only RouterOS group is marked READ MODE; actions stay visible but will not open.

  • /interfaceEthernet, VLAN, bonding, WiFi, tunnels, VRF, plus torch and counters.
  • /interface/wireguardInterfaces and peers: keys, endpoints, and allowed addresses.
  • /ipAddresses, DHCP, DNS, firewall, IPsec, hotspot, proxy, and related IP menus.
  • /pppSecrets, profiles, AAA, active sessions, and PPPoE/L2TP/SSTP/OpenVPN.
  • /interface/bridgePorts, hosts, VLANs, MDB, MSTI, filter, NAT, and port controller.
  • /interface/ethernet/switchChip, ports, VLAN, host, ACL, isolation, and L3HW.
  • /ipv6Addresses, ND, routes, pool, settings, firewall tables, and connections.
  • /routingTables, rules, OSPF instances and live interfaces, and BGP connections.
  • /systemUsers, identity, license, disks, device-mode, packages, scheduler, scripts, SNMP, certificates, history undo, and logs.

Built for people who already live on j and k.

Filter, sort, inspect, and jump with the command palette. Open another device with ctrl+t. The footer is the cheat sheet; ? opens the full map; i explains the open RouterOS menu.

  • j k ↑ ↓Move
  • enterOpen or edit
  • /Filter
  • ctrl+kPalette
  • ctrl+tNew device tab
  • F4Safe Mode
  • tTorch
  • `App logs
  • ?Help
  • iAbout
  • qQuit

Run it next to the router.

On macOS, install with Homebrew. On Linux (amd64 / arm64), run the install script. Windows: download a GitHub Release. First launch asks for host (192.168.88.1 orhost:port), username, and password.

# macOS
brew tap hafuta/routeros-tui
brew install routeros-tui

# Linux amd64 / arm64
curl -fsSL https://raw.githubusercontent.com/hafuta/routeros-tui/master/scripts/install-linux.sh | sh

Needs RouterOS 7.18 or newer and api-ssl (TLS, default port 8729) or the plaintext api service (default port 8728). Prefer TLS. Certificates are checked against the OS trust store, a CA file (enter to browse), or a pinned fingerprint. Saved files live under your OS config directory (~/.config/routeros-tui on Linux). An older mikrotik-tui directory is used until that path exists. See install for first-run setup.