The console is used for accessing the MikroTik Router's configuration and management features using text terminals, either remotely using serial port, telnet, SSH or console screen within Winbox, or directly using monitor and keyboard. The console is also used for writing scripts. This manual describes the general console operation principles. Please consult the Scripting Manual on some advanced console commands and on how to write scripts.
Login Options
Console login options enables or disables various console features like color, terminal detection and many other.
Additional login parameters can be appended to login name after '+' sign.
login_name ::= user_name [ '+' parameters ] parameters ::= parameter [ parameters ] parameter ::= [ number ] 'a'..'z' number ::= '0'..'9' [ number ]
If parameter is not present, then default value is used. If number is not present then implicit value of parameter is used.
Example: admin+c80w - will disable console colors and set terminal width to 80.
Param | Default | Implicit | Description |
---|---|---|---|
"w" | auto | auto | Set terminal width |
"h" | auto | auto | Set terminal height |
"c" | on | off | disable/enable console colors |
"t" | on | off | dDo auto detection of terminal capabilities |
"e" | on | off | Enables "dumb" terminal mode |
Banner and Messages
Login process will display MikroTik banner and short help after validating user name and password.
MMM MMM KKK TTTTTTTTTTT KKK MMMM MMMM KKK TTTTTTTTTTT KKK MMM MMMM MMM III KKK KKK RRRRRR OOOOOO TTT III KKK KKK MMM MM MMM III KKKKK RRR RRR OOO OOO TTT III KKKKK MMM MMM III KKK KKK RRRRRR OOO OOO TTT III KKK KKK MMM MMM III KKK KKK RRR RRR OOOOOO TTT III KKK KKK MikroTik RouterOS 6.22 (c) 1999-2014 https://www.mikrotik.com/ [?] Gives the list of available commands command [?] Gives help on the command and list of arguments [Tab] Completes the command/word. If the input is ambiguous, a second [Tab] gives possible options / Move up to base level .. Move up one level /command Use command at the base level
After the banner can be printed other important information, like system note set by another admin, last few crytical log messages, demo version upgrade reminder and default configuration description.
For example, demo license prompt and last crytical messages are printed
UPGRADE NOW FOR FULL SUPPORT ---------------------------- FULL SUPPORT benefits: - receive technical support - one year feature support - one year online upgrades (avoid re-installation and re-configuring your router) To upgrade, register your license "software ID" on our account server www.mikrotik.com Current installation "software ID": ABCD-456 Please press "Enter" to continue! dec/10/2007 10:40:06 system,error,critical login failure for user root from 10.0.0.1 via telnet dec/10/2007 10:40:07 system,error,critical login failure for user root from 10.0.0.1 via telnet dec/10/2007 10:40:09 system,error,critical login failure for user test from 10.0.0.1 via telnet
Command Prompt
At the end of successful login sequence login process prints banner, shows command prompt and hands over control to the user.
Default command prompt, consists of user name, system identity, and current command path />
For example, change current path from root to interface then go back to root
[admin@MikroTik] > interface [enter] [admin@MikroTik] /interface> / [enter] [admin@MikroTik] >
Use up arrow to recall previous commands from command history, TAB key to automatically complete words in the command you are typing, ENTER key to execute command, Control-C to interrupt currently running command and return to prompt and ? to display built-in help.
Easiest way to log out of console is to press Control-D at the command prompt while command line is empty (You can cancel current command and get an empty line with Control-C, so Control-C followed by Control-D will log you out in most cases).
It is possible to write commands that consist of multiple lines. When entered line is not a complete command and more input is expected, console shows continuation prompt that lists all open parentheses, braces, brackets and quotes, and also trailing backslash if previous line ended with backslash-whitespace.
[admin@MikroTik] > { {... :put (\ {(\... 1+2)} 3
When you are editing such multiple line entry, prompt shows number of current line and total line count instead of usual username and system name.
line 2 of 3> :put (\
Sometimes commands ask for additional input from user. For example, command '/password' asks for old and new passwords. In such cases prompt shows name of requested value, followed by colon and space.
[admin@MikroTik] > /password old password: ****** new password: ********** retype new password: **********
Hierarchy
The console allows configuration of the router's settings using text commands. Since there is a lot of available commands, they are split into groups organized in a way of hierarchical menu levels. The name of a menu level reflects the configuration information accessible in the relevant section.
For example, you can issue the /ip route print
command:
[admin@MikroTik] > ip route print Flags: X - disabled, A - active, D - dynamic, C - connect, S - static, r - rip, b - bgp, o - ospf, m - mme, B - blackhole, U - unreachable, P - prohibit # DST-ADDRESS PREF-SRC G GATEWAY DIS INTE... 0 A S 0.0.0.0/0 r 10.0.3.1 1 bridge1 1 ADC 1.0.1.0/24 1.0.1.1 0 bridge1 2 ADC 1.0.2.0/24 1.0.2.1 0 ether3 3 ADC 10.0.3.0/24 10.0.3.144 0 bridge1 4 ADC 10.10.10.0/24 10.10.10.1 0 wlan1 [admin@MikroTik] >
Instead of typing ip route path before each command, the path can be typed only once to move into this particular branch of menu hierarchy. Thus, the example above could also be executed like this:
[admin@MikroTik] > ip route [admin@MikroTik] ip route> print Flags: X - disabled, A - active, D - dynamic, C - connect, S - static, r - rip, b - bgp, o - ospf, m - mme, B - blackhole, U - unreachable, P - prohibit # DST-ADDRESS PREF-SRC G GATEWAY DIS INTE... 0 A S 0.0.0.0/0 r 10.0.3.1 1 bridge1 1 ADC 1.0.1.0/24 1.0.1.1 0 bridge1 2 ADC 1.0.2.0/24 1.0.2.1 0 ether3 3 ADC 10.0.3.0/24 10.0.3.144 0 bridge1 4 ADC 10.10.10.0/24 10.10.10.1 0 wlan1 [admin@MikroTik] ip route>
Notice that the prompt changes in order to reflect where you are located in the menu hierarchy at the moment. To move to the top level again, type " / "
[admin@MikroTik] > ip route [admin@MikroTik] ip route> / [admin@MikroTik] >
To move up one command level, type " .. "
[admin@MikroTik] ip route> .. [admin@MikroTik] ip>
You can also use / and .. to execute commands from other menu levels without changing the current level:
[admin@MikroTik] ip route> /ping 10.0.0.1 10.0.0.1 ping timeout 2 packets transmitted, 0 packets received, 100% packet loss [admin@MikroTik] ip firewall nat> .. service-port print Flags: X - disabled, I - invalid # NAME PORTS 0 ftp 21 1 tftp 69 2 irc 6667 3 h323 4 sip 5 pptp [admin@MikroTik] ip firewall nat>
Item Names and Numbers
Many of the command levels operate with arrays of items: interfaces, routes, users etc. Such arrays are displayed in similarly looking lists. All items in the list have an item number followed by flags and parameter values.
To change properties of an item, you have to use set command and specify name or number of the item.
Item Names
Some lists have items with specific names assigned to each of them. Examples are interface or user levels. There you can use item names instead of item numbers.
You do not have to use the print command before accessing items by their names, which, as opposed to numbers, are not assigned by the console internally, but are properties of the items. Thus, they would not change on their own. However, there are all kinds of obscure situations possible when several users are changing router's configuration at the same time. Generally, item names are more "stable" than the numbers, and also more informative, so you should prefer them to numbers when writing console scripts.
Item Numbers
Item numbers are assigned by the print command and are not constant - it is possible that two successive print commands will order items differently. But the results of last print commands are memorized and, thus, once assigned, item numbers can be used even after add, remove and move operations (since version 3, move operation does not renumber items). Item numbers are assigned on a per session basis, they will remain the same until you quit the console or until the next print command is executed. Also, numbers are assigned separately for every item list, so ip address print
will not change numbering of the interface list.
You can specify multiple items as targets to some commands. Almost everywhere, where you can write the number of item, you can also write a list of numbers.
[admin@MikroTik] > interface print Flags: X - disabled, D - dynamic, R - running # NAME TYPE MTU 0 R ether1 ether 1500 1 R ether2 ether 1500 2 R ether3 ether 1500 3 R ether4 ether 1500 [admin@MikroTik] > interface set 0,1,2 mtu=1460 [admin@MikroTik] > interface print Flags: X - disabled, D - dynamic, R - running # NAME TYPE MTU 0 R ether1 ether 1460 1 R ether2 ether 1460 2 R ether3 ether 1460 3 R ether4 ether 1500 [admin@MikroTik] >
General Commands
There are some commands that are common to nearly all menu levels, namely: print, set, remove, add, find, get, export, enable, disable, comment, move. These commands have similar behavior throughout different menu levels.
Property | Description |
---|---|
add | This command usually has all the same arguments as set, except the item number argument. It adds a new item with the values you have specified, usually at the end of the item list, in places where the order of items is relevant. There are some required properties that you have to supply, such as the interface for a new address, while other properties are set to defaults unless you explicitly specify them. Common Parameters
Return Values
|
edit | This command is associated with the set command. It can be used to edit values of properties that contain large amount of text, such as scripts, but it works with all editable properties. Depending on the capabilities of the terminal, either a fullscreen editor, or a single line editor is launched to edit the value of the specified property. |
find | The find command has the same arguments as set, plus the flag arguments like disabled or active that take values yes or no depending on the value of respective flag. To see all flags and their names, look at the top of print command's output. The find command returns internal numbers of all items that have the same values of arguments as specified. |
move | Changes the order of items in list. Parameters:
|
hows all information that\'s accessible from particular command level. Thus, /system clock print shows system date and time, /ip route print shows all routes etc. If there\'s a list of items in current level and they are not read-only, i.e. you can c hange/remove them (example of read-only item list is /system history , which shows history of executed actions), then print command also assigns numbers that are used by all commands that operate with items in this list.Common Parameters:
| |
remove | Removes specified item(-s) from a list. |
set | Allows you to change values of general parameters or item parameters. The set command has arguments with names corresponding to values you can change. Use ? or double Tab to see list of all arguments. If there is a list of items in this command level, then set has one action argument that accepts the number of item (or list of numbers) you wish to set up. This command does not return anything. |
Input Modes
It is possible to switch between several input modes:
- Normal mode - indicated by normla command prompt.
- Safe mode - safe mode is indicated by a word SAFE after command prompt. In this mode configuration is saved to disk only after safe mod eis turned off. Safe mode can bet turned on/off with Ctrl+c
- Hotlock mode - indicated by additional yellow >. Hotlock mode auto completes commands and can be turned on/off with Ctrl+v
List of Keys
Key | Description |
---|---|
Control-C | keyboard interrupt |
Control-D | log out (if input line is empty) |
Control-K | clear from cursor to the end of line |
Control-X | toggle safe mode |
Control-V | toggle hotlock mode mode |
F6 | toggle cellar |
F1or? | show context sensitive help. If the previous character is \, then inserts literal ?. |
Tab | perform line completion. When pressed second time, show possible completions. |
Delete | remove character at cursor |
Control-HorBackspace | remove character before cursor and move cursor back one position. |
Control-\ | split line at cursor. Insert newline at cursor position. Display second of the two resulting lines. |
Control-BorLeft | move cursor backwards one character |
Control-ForRight | move cursor forward one character |
Control-PorUp | go to previous line. If this is the first line of input then recall previous input from history. |
Control-NorDown | go to next line. If this is the last line of input then recall next input from history |
Control-AorHome | move cursor to the beginning of the line. If cursor is already at the beginning of the line, then go to the beginning of the first line of current input |
Control-EorEnd | move cursor to the end of line. If cursor is already at the end of line, then move it to the end of the last line of current input |
Control-LorF5 | reset terminal and repaint screen |