Difference between revisions of "Manual:Winbox"

From MikroTik Wiki
Jump to: navigation, search
Line 1: Line 1:
Winbox is a small utility that allows administration of Mikrotik RouterOS using a fast and simple GUI.
+
<h2>Summary</h2>
 +
<p>
 +
Winbox is a small utility that allows administration of Mikrotik RouterOS using a fast and simple GUI. It is a native Win32 binary, but can be run on <b>Linux</b> and <b>Mac OSX</b> using Wine.
 +
</p>
 +
<p>
 +
All Winbox interface functions are as close as possible to Console functions, that is why there are no Winbox sections in the manual.
 +
</p>
  
Winbox is a native Win32 binary, but can be run on Linux and Mac OSX using Wine.
+
<h2>Starting the Winbox</h2>
 +
<p>
 +
Winbox loader can be downloaded directly from the router.
 +
</p>
 +
<p>
 +
Open your browser and enter router's IP address, RouterOS welcome page will be displayed. Click on the link to download <b>winbox.exe</b>
 +
</p>
 +
[[File:win-web-snap.png]]
  
 +
<p>
 +
When winbox.exe is downloaded, double click on it and winbox loader window will pop up:
 +
</p>
 +
[[File:winbox-loader.png]]
  
 +
<p>
 +
To connect to the router enter IP or MAC address of the router, specify username and password (if any) and click on <b>Connect</b> button.
 +
</p>
 +
{{ Note | It is recommended to use IP address whenever possible. MAC session uses network broadcasts and is not 100% reliable.}}
 +
 +
<p>
 +
You can also use neighbor discovery, to list available routers by clicking on <b>[...]</b> button:
 +
</p>
 +
[[File:winbox-loader2.png]]
 +
 +
From list of discovered routers you can click on IP or MAC address column to connect to that router. If you click on IP address then IP will be used to connect, but if you click on MAC Address then MAC address will be used to connect to the router.
 +
 +
{{ Note | Neighbor discovery will show also devices which are not compatible with Winbox, like Cisco routers or any other device that uses CDP (Cisco Discovery Protocol) }}
 +
 +
 +
<p>
 +
Description of buttons and fields of loader screen
 +
<ul class="bullets">
 +
<li><b>[...]</b> - discovers and shows MNDP (MikroTik Neighbor Discovery Protocol) or CDP (Cisco Discovery Protocol) devices.
 +
<li><b>Connect</b> - Connect to the router
 +
<li><b>Save</b> - Save address, login, password and note. Saved entries are listed at the bottom of loader window.
 +
<li><b>Remove</b> - Remove selected entry from saved list
 +
<li><b>Tools...</b> - Allows to run various tools: removes all items from the list, clears cache on the local disk, imports addresses from wbx file or exports them to wbx file.
 +
</ul>
 +
<br />
 +
<ul class="bullets">
 +
<li><b>Connect To:</b> - destination IP or MAC address of the router
 +
<li><b>Login</b> - username used for authentication
 +
<li><b>Password</b> - password used for authentication
 +
<li><b>Keep Password</b> - if unchecked, password is not saved to the list
 +
<li><b>Secure Mode</b> - if checked, winbox will use TLS encryption to secure session
 +
<li><b>Load Previous Session</b> - if checked, winbox will try to restore all previously opened windows.
 +
<li><b>Note</b> - description of the router that will be saved to the list.
 +
</ul>
 +
</p>
 +
{{ Warning | Passwords are saved in plain text. Anyone with access to your file system will be able to retrieve passwords. }}
 +
 +
<h2>Work Area</h2>
 +
[[File:Winbox-workarea.png]]
 +
<p>
 +
 +
</p>
  
 
== Transferring Settings ==
 
== Transferring Settings ==

Revision as of 12:48, 12 April 2010

Summary

Winbox is a small utility that allows administration of Mikrotik RouterOS using a fast and simple GUI. It is a native Win32 binary, but can be run on Linux and Mac OSX using Wine.

All Winbox interface functions are as close as possible to Console functions, that is why there are no Winbox sections in the manual.

Starting the Winbox

Winbox loader can be downloaded directly from the router.

Open your browser and enter router's IP address, RouterOS welcome page will be displayed. Click on the link to download winbox.exe

Win-web-snap.png

When winbox.exe is downloaded, double click on it and winbox loader window will pop up:

Winbox-loader.png

To connect to the router enter IP or MAC address of the router, specify username and password (if any) and click on Connect button.

Icon-note.png

Note: It is recommended to use IP address whenever possible. MAC session uses network broadcasts and is not 100% reliable.


You can also use neighbor discovery, to list available routers by clicking on [...] button:

Winbox-loader2.png

From list of discovered routers you can click on IP or MAC address column to connect to that router. If you click on IP address then IP will be used to connect, but if you click on MAC Address then MAC address will be used to connect to the router.

Icon-note.png

Note: Neighbor discovery will show also devices which are not compatible with Winbox, like Cisco routers or any other device that uses CDP (Cisco Discovery Protocol)



Description of buttons and fields of loader screen

  • [...] - discovers and shows MNDP (MikroTik Neighbor Discovery Protocol) or CDP (Cisco Discovery Protocol) devices.
  • Connect - Connect to the router
  • Save - Save address, login, password and note. Saved entries are listed at the bottom of loader window.
  • Remove - Remove selected entry from saved list
  • Tools... - Allows to run various tools: removes all items from the list, clears cache on the local disk, imports addresses from wbx file or exports them to wbx file.


  • Connect To: - destination IP or MAC address of the router
  • Login - username used for authentication
  • Password - password used for authentication
  • Keep Password - if unchecked, password is not saved to the list
  • Secure Mode - if checked, winbox will use TLS encryption to secure session
  • Load Previous Session - if checked, winbox will try to restore all previously opened windows.
  • Note - description of the router that will be saved to the list.

Icon-warn.png

Warning: Passwords are saved in plain text. Anyone with access to your file system will be able to retrieve passwords.


Work Area

Winbox-workarea.png

Transferring Settings

On Windows Vista/7 Winbox settings are stored in:  %USERPROFILE%\AppData\Roaming\Mikrotik\Winbox\winbox.cfg

Simply copy this file to the same location on the new host.