C library to communicate with network devices by MikroTik running their Linux-based operating system RouterOS.
Clone or download
manio Fix computing bytes fields (memory and disk space)
It seems that all new RouterOS versions are reporting those fields
as bytes, so remove the multipliers introduced in 460236c.

Successfully tested on the following RouterOS versions:
- 6.38.5 (stable)
- 6.42.1 (stable)
- 6.42.3 (stable)
- 6.43rc42 (testing)

The revert is partial (not affecting CPU frequency).
Closes #6
Latest commit c485c77 Jul 19, 2018



librouteros is a library to communicate with RouterOS, the operating system of MikroTik's RouterBoards. It uses the API port provided by those systems to connect and talk to the devices. librouteros is a low-level library in that it abstracts the network protocol used but has next to no knowledge about the commands and responses available. Should such an high-level interface prove useful, it will be added as the need arises.

Enabling API connections

API connections (sometimes also called “Winbox connections”) must be explicitly enabled. To do so, issue the following command:

/ip service enable api

To allow a specific user / group to use the API, the “winbox” item must be added to the user's “policy” in “/user group”.


There's currently no mailing list available for librouteros. In case of questions, suggestions and feedback in general, please contact the author directly (see Author below).


librouteros is licensed under the terms of the ISC License. Terms of the license can be found in the file COPYING.

See also

Information about MikroTik and RouterOS can be found on MikroTik's homepage. The API documentation used to write this library is available from the Mikrotik wiki.


librouteros was originally written in 2009 by Florian Forster <ff at octo.it> (@octo on Github).

Additional contributors are listed in the file called AUTHORS.