≡ Menu

Debian Linux: Set a Serial Console

How do I set up a serial console on Debian Linux HP server for troubleshooting and login purpose?

To setup a serial console you need to edit the following files under Debian Linux:

  1. /boot/grub/menu.lst or /etc/default/grub (recommended for grub2)
  2. /etc/inittab
  3. /etc/securetty

Our Setup

You can list your working serial port under Linux as follows:
# setserial -g /dev/ttyS[0123]
Sample outputs:

/dev/ttyS0, UART: 16550A, Port: 0x03f8, IRQ: 4
/dev/ttyS1, UART: unknown, Port: 0x02f8, IRQ: 3
/dev/ttyS2, UART: unknown, Port: 0x03e8, IRQ: 4
/dev/ttyS3, UART: unknown, Port: 0x02e8, IRQ: 3

/dev/ttyS0 (COM1) is detected and working serial console under Linux. For testing purpose, I’m going to set baud rate to 19200 and terminal type to vt100.

Grub Configuration (Grub2)

Edit /etc/default/grub, enter:
# vi /etc/default/grub
Append / modify as follows:

GRUB_CMDLINE_LINUX='console=tty0 console=ttyS0,19200n8'
GRUB_SERIAL_COMMAND="serial --speed=19200 --unit=0 --word=8 --parity=no --stop=1"

Save and close the file. Next run the following command to generate a grub2 config file /boot/grub/grub.cfg :
# update-grub

A Note About Grub Legacy (older version)

If you are not using GRUB2 update /boot/grub/menu.lst (grub legacy) with kernel line as follows with console port, and baud rate:

title           Debian GNU/Linux, kernel 2.6.32-5-486
root            (hd0,0)
kernel          /boot/vmlinuz-2.6.32-5-486 root=UUID=b598f856-2a2a-46d5-b60a-95826cfc7bf6 ro console=ttyS0,19200 earlyprint=serial,ttyS0,19200
initrd          /boot/initrd.img-2.6.32-5-486

Save and close the file.

/etc/inittab Configuration

Edit /etc/inittab, enter:
# vi /etc/inittab
You need put a getty on a serial line for a terminal:

T0:23:respawn:/sbin/getty -L ttyS0 19200 vt100

Save and close the file.

/etc/securetty Configuration

Edit /etc/securetty, enter:
# vi /etc/securetty
Make sure UART serial ports /dev/ttyS0 is listed:


Save and close the file. Now, you can reboot the server for testing purpose.

How Do I Connect Using a Serial Console?

You need to use the minicom command, which is a communication program that runs under most unices. You can install minicom as follows on your Debian / Ubuntu desktop system:
# apt-get install minicom
For rpm based distro such as RHEL / Fedora / CentOS Linux, enter:
# yum install minicom
Run minicom as follows to create a configuration file:
# minicom -s -c on
Press [down] key and select Serial port setup:

Fig.01: Setting up minicom serial port

Fig.01: Setting up minicom serial port

  1. Press A to setup serial device name such as /dev/ttyS0
  2. Press E to setup Bps/Par/Bits (baud rate)
  3. Press [ESC] to exit
  4. From menu select “Save setup as DFL”
  5. Exit

Alternatively, you can create minicom config DFL file as follows:
# cat /etc/minicom/minirc.dfl
pu port /dev/ttyS0
pu baudrate 19200
pu bits 8
pu parity N
pu stopbits 1
pu rtscts No

Save and close the file. To connect to a serial console simply type the minicom command as follows:
# minicom
Sample outputs:

Fig.02: Minicom in action

Fig.02: Minicom in action

How Do I Connect From MS-Windows XP / 2000 / Vista / 7 Desktop System?

You can use the HyperTerminal or putty client as described here.

How Do I Connect To a Serial Console Over IP Network?

You need to use the KVM over IP client as described here or use the ipmitool command line tool for serial console redirection over IP (LAN/WAN). It is highly recommend that you access server over a serial console using some sort of VPN to encrypt all traffic.

Share this tutorial on:

Your support makes a big difference:
I have a small favor to ask. More people are reading the nixCraft. Many of you block advertising which is your right, and advertising revenues are not sufficient to cover my operating costs. So you can see why I need to ask for your help. The nixCraft, takes a lot of my time and hard work to produce. If you use nixCraft, who likes it, helps me with donations:
Become a Supporter →    Make a contribution via Paypal/Bitcoin →   

Don't Miss Any Linux and Unix Tips

Get nixCraft in your inbox. It's free:

{ 5 comments… add one }
  • yoander January 26, 2011, 6:49 pm

    Hey vivek, you could write Debian GNU / Linux instead of Debian Linux

    • yoander August 9, 2011, 9:43 pm

      derpa derp derp as derpa gnu derp

  • Bob July 30, 2013, 11:23 pm

    The images are down :(

  • Mike Schmitz December 31, 2014, 7:06 pm

    You might remind people that they need a null-modem connector to make this work.

  • Brian July 17, 2016, 10:36 pm

    I use the getty command ‘/sbin/getty -L ttyUSBupper 9600 vt100’ , and success prompt to upper USB , but why I put in

    /etc/inittab :

    T1:23:respawn:/sbin/getty -L ttyUSBupper 9600 vt100

    It just can not work while the Raspberry pi3 boot up ?

    Brian Lai

Security: Are you a robot or human?

Leave a Comment

You can use these HTML tags and attributes: <strong> <em> <pre> <code> <a href="" title="">

   Tagged with: , , , , , , , , , , , , , , , , , , , , ,