Checking for updates
The Upgrades page asks each selected device what it is running and what it could run. This is a live query against the routers, not a cached guess, so a check on a large fleet takes as long as the slowest device.
The page has four tabs: Devices, Runs, Schedules and Package repository. A viewer sees only Devices. Runs and Schedules are for admins and operators, and Package repository for an admin without a site scope.
Checks run five devices at a time from a pool that refills as slots free up — a new device starts as soon as one finishes, so one slow or unreachable device delays itself, not the batch behind it. The page shows the latest RouterOS releases separately, so you can see what is current even before checking anything.
A check reports two independent things: the RouterOS version and the routerboard firmware. They move separately, and a device can be current on one and behind on the other.
Between checks the RouterOS verdict follows the channel. mikr reads the newest release on each channel once an hour, from the same MikroTik file a router's own check reads, and every poll raises a device's latest version to what its channel offers. A fleet checked before a release shows Available once that release is out, with no new check. The value only ever goes up. A device whose channel is not known yet waits for a check, and so does every device when mikr cannot reach MikroTik's update server. (v1.100.0+)
Reading the release notes first
A version number does not say whether you want it. The Upgrades page carries a badge for the newest release on each of the four channels, and clicking one reads that version's RouterOS changelog without leaving mikr. On a single device, What's new sits inside the update dialog, beside the options.
The entries are grouped by package, so a release with a few hundred lines reads as sections rather than a wall. Anything MikroTik marked with its own !) flag, and anything naming a CVE, is pulled to the top and highlighted. Everything else keeps the vendor's wording exactly.
The text is fetched from MikroTik when you ask for it, so a version MikroTik has not published — a build your device is running from the testing branch, for instance — will report that no changelog exists rather than showing a stale one.
The three upgrade actions
| Action | What happens |
|---|---|
| Upgrade RouterOS | Downloads and installs the RouterOS package, then reboots to apply it, then verifies what came back up. A device already running something newer than its channel offers is skipped with No newer version and left as it is. (v1.91.0+) A device that takes the install but never restarts, its uptime still growing, fails with Device did not reboot and what the device printed, so you can run it again or install from the device itself. (v1.106.0+) |
| Upgrade firmware | Writes the routerboard firmware and reboots. Firmware is only applied on reboot, so this always costs a restart. When the new firmware was already written earlier and the device was never restarted, RouterOS answers that the firmware is already up to date; the device is then just rebooted to apply it. (v2.4.0+) |
| Full upgrade | RouterOS first; when that is done — or when the device turned out to be current already — it re-checks the firmware and upgrades it only if there is something to install. Two reboots at most, one if only one part was behind. |
Full upgrade is the one to reach for. Doing RouterOS and firmware as two separate passes over the same fleet means two rounds of reboots for no benefit.
Those three are buttons on the Devices tab, where you are acting on a selection of devices, and each asks you to confirm the selection before anything starts. They sit in a bar above the table that shows its buttons once at least one device is selected. The bar then says how many devices are selected and how many of them are behind on RouterOS, have firmware waiting, are up to date or were never checked. Check for Updates, Schedule…, Change channel… and the failure limit are in the same bar. On a single device's own page the same choice arrives differently: when a check finds an update, one Update button appears carrying the version it would install, and it opens a short dialog offering the full upgrade, RouterOS only, or firmware only — each stating what it installs and how many reboots to expect. That version's release notes open in the same dialog, so you can read them and choose without going anywhere. There is no second confirmation behind those buttons: the dialog is it.
A plain Reboot is not one of these. It is a single-device action and it lives on the device's own page — and as a swipe action in the phone device list — because it installs nothing. The connection dropping is treated as success, because that is what a reboot looks like from outside.
Whichever way a device is managed, the install itself is attempted over SSH first, and the REST API is used only when SSH cannot be reached on a device set up for REST. It is worth leaving SSH open on anything you intend to upgrade.
Picking devices
The box above the table narrows it before you select. A plain word matches a device's name, identity, address, site or model, and anything shown in its row, so Available or 7.19 work too. To be precise, name a field: name:, host:, site:, model:, ros: for the installed RouterOS version, fw: for firmware, channel: for the update channel, tag:, and status: followed by behind, fw-behind, current, unchecked, online or offline. Several terms narrow together, and each value is a regular expression, so name:^cpe1 model:hap status:behind means what it reads as. (v1.88.0+)
Above the table, a row of state buttons narrows it too: All, Behind, Firmware waiting, Up to date and Pre-release, each with its count. Behind means a newer RouterOS is available, and Firmware waiting means the firmware has an upgrade ready. Pre-release is a beta or release candidate, or a device on the development channel. A device that has never been checked is counted under All only. Clicking the active button again goes back to All.
A device the filter hides is also deselected, and every bulk button acts only on what is shown, so nothing out of sight is upgraded. The same box appears in the queue, the schedule picker, on the Commands page and in the template dialog.
Next to the box, a site picker shows one site at a time and works together with it (v1.99.0+). It also works together with the state buttons. The browser tab remembers your choice of site and state. With All sites the table is grouped by site, and each site row has a checkbox that selects every device of that site shown. It shows a dash while only some of them are ticked. Once an upgrade or a schedule is accepted, the devices you sent are unticked, so they do not go along with the next batch. Check for Updates and Change channel keep the selection, because an upgrade of the same devices usually follows.
Changing the update channel
Every device follows one of RouterOS's four update channels: stable, long-term, testing or development. A check or an upgrade only ever sees what that channel offers. The channel is the badge next to the installed version in the table.
To change it, select the devices and press Change channel…. The dialog lists every selected device with its current channel and the one it will move to, and nothing is written until you confirm that list. Devices that will not be changed stay in the list, greyed out, with the reason: offline, disabled, SNMP-only, a read-only RouterOS account, or already on that channel. A device whose channel has not been read yet shows it as unknown and is changed like any other. (v1.91.0+)
Going back is the same action. The last entry in the target list, Previous channel, returns each device to the channel it was on before mikr last changed it. It works per device, so a batch that mixed stable and long-term goes back to both. A device whose channel mikr has never changed has no previous channel and is left alone.
Changing a channel installs nothing. Each device checks for updates on its new channel straight away, so the table shows what the new channel offers, not what the old one did. If that check does not confirm the new channel, the device is reported as failed. The dialog warns when the target is testing or development, and it names devices that have a scheduled or queued upgrade without a pin: that upgrade will install whatever the new channel offers.
Moving to a channel with an older release does not roll a device back. Upgrades from the buttons, the queue and schedules all skip a device that already runs something newer than its channel offers, and the device stays on its version until the channel catches up. mikr does not downgrade RouterOS.
The table shows the channel the device reported the last time it was polled over SSH or REST, or checked for updates. For a device polled over SNMP, only a check refreshes it, so run Check for Updates first if the channel shown may be out of date.
Changing a channel needs the admin or operator role and stays within your site scope, the same as upgrading. The activity log records both the request and the channel each device ended up on.
The sequential queue
Upgrading a whole site at once is rarely what you want: the moment a distribution switch reboots, everything behind it goes dark and its own upgrade never reports back. The queue exists for that. It runs one device at a time, in an order you control, and only one queue runs at a time across the whole installation. The queue is on the Runs tab.
Filling the queue
Devices go into the queue by dragging them from the list on the left, or by clicking one to append it. For a fleet-wide run there is Add all needing update above that list: it queues every online device that is behind in one press, and the number on the button is the number it will add. (v1.81.0+)
A device dropped onto the queue lands where you drop it, above or below the row under the pointer, and the strip under the list adds at the end. The list on the left takes the same filter as the Upgrades table: Add all shown queues everything the filter leaves, and Add all needing update counts only those. (v1.88.0+)
What counts as behind follows the RouterOS / Firmware / Both choice next to the queue, and it is the same judgement the Upgrades table shows as Available — a device already running a newer version than the update it last heard about is never added, and if one is queued by hand anyway, it is skipped when its turn comes. A device that has never been checked for updates says nothing either way; those are left out rather than treated as up to date, and the confirmation tells you how many were passed over. Run Check for Updates on the Devices tab first if you want them included.
PoE-aware ordering
Before starting, the queue can work out an order from the PoE topology of the devices you selected — which device powers which. Powered devices are handled before the device feeding them, so nothing is upgraded through a link that is about to disappear.
This uses what the devices report about their own PoE ports. It orders what it can see; it is not a substitute for knowing your own topology, and an uplink that carries no PoE is invisible to it.
When a device stops responding
Every step of an upgrade has a time limit — installing, writing firmware, rebooting, and each check against MikroTik's update server. A device that goes quiet is marked failed with the reason, and the queue moves on to the next one; it does not wait indefinitely, and it does not report a silent device as upgraded. The limits are generous, so a slow link is not mistaken for a failure. If a queue stalls regardless, starting a new one releases it. (v1.72.1+)
Stopping after too many failures
A release that breaks on your hardware, or a configuration it does not agree with, should reach as few devices as possible. Under Settings → Safety stop an administrator can set how many failed devices end an upgrade run, a percentage of the run's devices, or both; both are off until set. A single run can set its own count in the field beside the queue's start button, or beside the upgrade buttons above the table, and 0 there turns the stop off for that run. (v1.88.0+)
The queue upgrades one device at a time, so it stops exactly at the limit and cancels the devices still waiting. The upgrade buttons above the table work through several devices at once: when the limit is reached no further device is started, the ones already upgrading are left to finish, since cutting an install off midway is worse, and the rest are reported as held. The percentage is a share of every device in the run, not of those tried so far: at 5%, a run of 200 devices stops at its tenth failure, wherever in the run it happens. A run too small for the percentage to allow even one failure stops at the first, so for a small run the count is the better limit. (v1.89.0+)
By default a safety stop also pauses scheduled upgrades, so the same release is not sent out again at the next scheduled time. The Schedules tab then says so and offers Resume. A queue in which any device failed finishes marked as failed.
Cancelling
A running queue can be stopped with Cancel Queue, which asks first. The device currently being upgraded finishes first. A queue that was interrupted by the manager itself restarting is marked failed rather than silently resumed — a half-finished upgrade run is not something to continue blind.
Scheduled upgrades
An upgrade can be scheduled per device, so the reboot lands in a window you chose rather than in the middle of the working day. Schedules are listed and managed together on the Schedules tab, and Clear all… removes them in bulk after asking first. The list shows the RouterOS version each device is on and the latest it knows about, so you can tell at a glance whether a scheduled upgrade is still needed.
There are two ways to create one. On the Upgrades table, select the devices as you would for an immediate upgrade — the filter and the site checkboxes apply — and press Schedule…, which asks only for the time and the upgrade type; as with every bulk action there, only devices visible under the current filter are taken. The Schedules tab also has a device picker of its own for the same job. A device holds one schedule at a time, so scheduling it again moves it rather than adding a second run.
A device with an upgrade waiting is marked on the Upgrades table, beside its name, with the time of the run. Hover the mark to see where it comes from: the device's own schedule or a scheduled preset by name, and the upgrade type. Like the Schedules tab, the mark is shown to admins and operators. (v1.102.0+)
A scheduled preset is a run of its own, separate from the device's own schedule. A device that has both is upgraded twice, so its mark turns amber, reads Scheduled ×2 and lists both runs. A device in several scheduled presets is counted the same way. Take the device out of one of them if that is not what you want.
Scheduling does not change what an upgrade does — it changes when. Everything on this page still applies, including the fact that a firmware upgrade reboots.
Pinning the version
RouterOS installs whatever its update channel offers at the moment the upgrade runs, so a release published between scheduling and the maintenance window would go out without anyone having read it. Every way of scheduling offers Pin to the version available now, which ties each device to the RouterOS version it was last offered. When the time comes the device checks again, and if its channel offers anything other than that version it is held: nothing is installed, the firmware step is skipped with it, and the log names both versions. A device already on the pinned version, or past it, is skipped. (v1.88.0+)
A pin cannot make RouterOS install a particular release; it can only decline a different one. It also needs a version to pin to, so run Check for Updates on the devices first — a pinned schedule is refused, naming the devices, if any of them has never been checked. Firmware-only schedules are not pinned, because firmware follows the installed RouterOS.
Scheduling a saved queue
A queue you have arranged can be saved as a preset and loaded again later — useful for a run you repeat, such as a monthly pass over the branch routers. From 1.86.0 a preset can also be given its own time: open Manage… beside the preset picker and press Schedule… on the preset you want.
The difference from scheduling devices one by one is the order. A preset keeps the sequence you arranged, so a run built around which device powers which arrives at its window intact rather than being reassembled. It runs once, and the pending time is shown on the preset with a Clear button beside it. Devices you deleted or disabled in the meantime are skipped and the rest keep their places; if a queue happens to be running when the time comes, the preset waits and starts once that queue is finished.
Watching a run
Starting an upgrade returns immediately; the work continues in the background. Progress arrives over a live connection, phase by phase — checking, installing, rebooting, verifying.
Running upgrades stay visible from any page in the Active Tasks tray, and survive a page reload: closing the tab does not stop the run and does not lose its log. If nothing moves at all, the live connection is the first thing to suspect rather than the upgrade — see Troubleshooting.
A finished batch can also fire a webhook, so a fleet-wide run can report its own summary without anyone watching the page.
Once a run is over it stays under System → Task History, with each device's result and, for a device that failed, the step it had reached. See Task History. (v1.100.0+)
Local package repository
RouterOS can serve packages to other RouterOS devices itself: one device holds the files, and the others download them from it under System → Packages → Local Update instead of from MikroTik. The Package repository tab on the Upgrades page keeps that device's folder filled with what your fleet needs. It does not change the Local Update setting on the other devices; you point them at the server yourself. (v1.105.0+)
The tab needs the admin role on an account without a site scope, since it counts every device in the installation.
Setting up the server
Pick one device as the server. There is one per installation, and it has to be managed over SSH. Then pick where the files go: one of the device's mounted disks, NVMe, SATA or USB, with its free space shown, or its built-in flash. Flash is small and wears with every write, and one RouterOS release takes 11 to 21 MB per architecture before any extra package, so use a disk where the device has one. On flash a sync always leaves 16 MiB free for RouterOS.
The folder name takes letters, digits, - and _. Each version gets its own folder inside it, for example mikr-repo/7.24.5/, and the devices using Local Update find the packages there.
The account the manager uses on the server needs the test and ftp policies, because the server downloads the files itself. The manager group recommended in Getting Started has neither, so add both to the account on that one device. Without them a sync stops at the first file and says which policies are missing.
What it keeps
For each architecture in the fleet, the newest release of every update channel that architecture's own devices follow. One device on the development channel does not bring a beta in for every other architecture. The table on the tab lists each architecture with its devices, channels and packages, and marks every version as present, missing, or with how many of its files are missing.
The routeros package is always kept. With Extra packages too ticked, so is every other package a device of that architecture has installed, such as wifi-qcom or container. Installed packages are read over SSH once a day. A device polled over SNMP never reports them, so its extra packages are kept only when another device of the same architecture runs them too. The table says how many devices of each architecture have reported theirs.
Versions to keep (1 to 20, 3 by default) decides how many version folders stay. After a sync in which nothing failed, older version folders are deleted, but never a version that a channel in the fleet still offers, and never a file the manager did not put there. A sync with a failed download deletes nothing.
Syncing
Sync has the server download every missing file from download.mikrotik.com, one at a time, and checks each one in the server's file list afterwards. It runs as a task in Active Tasks and stays in Task History. A sync does not start while another one runs, or when the files will not fit in the free space. A file MikroTik does not publish for an architecture is noted and not asked for again.
With Sync automatically ticked, a sync starts on its own ten minutes after the manager's hourly check of the update channels finds a new release on one the fleet follows. It is off by default.
When an upgrade is refused
Two refusals are deliberate and worth recognising:
- A read-only RouterOS account. If the account stored for the device has no write policy, the upgrade is refused up front rather than attempted and failed halfway. The device carries a read-only badge for exactly this reason — see the account setup.
- Your role. Upgrading and changing the update channel require the admin or operator role; a viewer can see versions and what is available, and nothing more. See Users and access.
Site scope applies on top of the role: an upgrade only ever touches devices you are allowed to touch, checked on the server rather than in the browser. It covers queues and presets as well: a scoped user sees and can cancel only a queue whose devices are all in their sites, sees and edits only presets whose devices are all in their sites, and Clear all… on the Schedules tab clears only their own devices' schedules. (v1.102.0+)