Documentation updates - November 5, 2026
Summary of documentation changes made on November 5, 2026.
Containers
- Apps: Rewrote the app documentation and removed the commands that now have their own reference pages. The app CLI reference describes
settings,setup,update,cleanup,network,restartandremove, including the networks flags andallow-outgoing-access. - Containers: Added the steps to enable containers before the first one: install the
containerpackage and turn containers on in device-mode, where they are off by default.
Bridging & Switching
- Bridging and Switching: Bridged traffic bypasses the IP/IPv6 firewall unless
use-ip-firewallis enabled. Theuse-ip-firewalldescription explains what enabling it changes: bridge Fast Path turns off, so FastTrack stops for that traffic, and the extra chains cost CPU. Routed traffic and VLAN interfaces on the bridge already pass the IP firewall. - Bridging and Switching: DHCP snooping applies to all VLANs of the bridge by default; the
dhcp-snooping-vlan-idsproperty limits it to the listed VLANs, and DHCP messages in the other VLANs are forwarded without snooping. The example uses two switches in VLAN 10 with Option 82. - Bridge VLAN table: Named the switch chip section clearly and pointed the VLAN pages at the trunk/access example.
Firewall & QoS
- Filter: New section on blocking a connection that is already open. A drop rule after the rules that accept or FastTrack established connections stops only new connections; to stop open ones, put the drop rule before them.
- PCQ example: Realistic per-device limits for a whole LAN (10 Mbit/s download, 5 Mbit/s upload), with
pcq-classifierandpcq-rateunits, and a note that FastTracked traffic bypasses the queue.
Getting Started
- First time configuration: The port-forward example now limits the rule with
in-interface-list=WANand explains what happens without it: local devices connecting to that port on any internet server would be redirected too. - Upgrade: Added the command-line upgrade steps (
/system/package/update/check-for-updatesandinstall). - Securing your router: When the router is the DNS server for the network, keep
allow-remote-requests=yes; the default firewall drops DNS queries from the internet.
Hardware
- RouterBOARD pages, RB911 series: Added product specification tables to the RouterBOARD documentation, moved the specifications under the Extension slots and ports section, standardized the Reset button sections, linked the product names, bulleted the safety warnings, and removed the leftover Confluence formatting.
- Hardware pages: The RouterOS update instructions now link the Downloads section of each product page.
Management Tools
- WinBox: Documented the Set file password action, which encrypts the saved passwords in the
.cdbdevice list (the most recently used password cannot be encrypted), and thewinboxservice on TCP port 8291, including how to change the port. - CMR: Changes that CMR makes on a client are now documented as
cmr:<user>@<address>in the client log. The cmr/vlan rule requiresport-labels, so a VLAN rule always names the ports it configures instead of applying to every port of a device.
Network Management
- DHCP server: New example for giving a device a fixed address with a static lease, without changing anything on the device.
- DHCP server: The server's
address-listsadd the address of each bound lease to firewall address lists; a static lease's ownaddress-listsoverride the server's lists for that lease.
System
- Neighbor discovery: LLDP neighbors are in a separate table (
/ip/neighbor/lldp), now documented on the page, in the CLI reference and for SNMP.
User Guides
- Policy routing: New example that sends one device through a second WAN, with a routing table, a
check-gateway=pingroute and a routing rule.
VPN
- EoIP: Documented EoIPv6 (
/interface/eoipv6) as a separate encapsulation (next header 97 with a 2-byte tunnel ID, not GRE), thetunnel-idrequirement (a mismatch keeps the running flag off; with keepalive off the flag stays up), and the MTU arithmetic: 1458 bytes over IPv4 and 1444 over IPv6 on a 1500-byte path.
High Availability Solutions
- Bonding: Added an LACP example (
mode=802.3ad) and stated that the default mode isbalance-rr. - Failover WAN backup: The host routes and default routes now appear in one configuration block.
Authentication & AAA
- User: New example for creating a read-only user: a group with the
readpolicy and the policies of the login tools, then a user in that group.