Serial Console
The serial console is a terminal on a server's serial port, opened in the browser. It works when the server has no network, and it shows the boot messages VNC scrolls past.
It runs through the relay and agent, so the relay must be installed on the control server first.
What the server needs
The console shows whatever the server's operating system sends to its first serial port. A system that
does not use the serial port shows nothing. Most Linux cloud images do; on others, enable a login on the
serial port (ttyS0) inside the server.
Who can open it
Administrators can always open a server's serial console, from the Serial Console button at the top of the server's page.
A server's owner can open it in the client area when all of these are on:
- Settings > General > Users > Allow Serial Console, the global switch.
- The server's own setting, Allow Serial Console under Settings > General > Misc on the server's page. A new server takes it from its package (Serial Console on the package). To change several servers at once, select them in the server list and use Allow Serial Console or Disallow Serial Console.
A user the server is shared with also needs the VNC permission on that share.
Where it is allowed, the server's Options area in the client area has a Console tab with an Open Console button.
Using it
The console opens in its own window. Its toolbar has:
- Keys: send keys a browser or a touch keyboard would otherwise keep, such as Esc, Tab, Ctrl+C and the arrow keys.
- Clipboard: paste text into the server. Text of more than one line asks before it is sent.
- Search: find text in what the console has shown.
- Display: change the font size, and tell the server the size of the window.
- Power: boot, restart, shut down or power off the server.
- Save log: download what the console has shown.
One console can be open on a server at a time. A second one is refused until the first is closed.
A console with no activity for 30 minutes is closed. It is also closed within a few seconds when the access it was opened with is taken away: the share is removed or switched off, or the serial console is disallowed for the server.