Good news!

Teamviewer for Linux work on headless systems as well. 

Bad News...

You'll probably have to do some little change and reboot once before it will work.

One common case is when you try to start the setup 

# teamviewer setup

and the machine will reply:

The framebuffer console seems to be unavailable or has the wrong format. Please make sure that /dev/fb0 is accessible and it is configured to 32-bit depth

So how to do?

Requirements and setup

To set up headless for TeamViewer, you’ll need:

  • a Teamviewer account
  • your kernel has to be configured to use a framebuffer.
  • you also need to be root to configure TeamViewer headless support.

TeamViewer 12 x86 64bit

Download last version of Teamviewer host x86 64bit:



apt install teamviewer_i386.deb

OR (for older systems Ubuntu 14.04, Debian 7 and below):

dpkg -i teamviewer_i386.deb

In case dpkg indicates missing dependencies, complete the installation by executing the following command:

apt-get install -f

This is the link with the installation guidelines from official website:

After this you could try to execute

teamviewer setup

if you get this error:

"The framebuffer console seems to be unavailable or has the wrong format. Please make sure that /dev/fb0 is accessible and it is configured to 32-bit depth"

proceed like this:

apt-get install v86d

check which vbe modes are supported:

cat /sys/bus/platform/drivers/uvesafb/uvesafb.0/vbe_modes

you should get a list similar to this one (more or less):

640x480-8, 0x0101
640x480-16, 0x0111
640x480-15, 0x0110
640x480-24, 0x0112
800x600-8, 0x0103
800x600-16, 0x0114
800x600-15, 0x0113
1024x768-8, 0x0105
1024x768-16, 0x0117
1024x768-15, 0x0116
800x600-24, 0x0115
1024x768-24, 0x0118
1280x1024-8, 0x0107
1280x1024-15, 0x0119
1280x1024-16, 0x011a
320x200-8, 0x0013

edit the modules file:

nano /etc/initramfs-tools/modules

and add the following line (choose amongst supported resolutions listed before one that has 24 or 32 bit depth)

uvesafb mode_option=1024x768-24

save and exit

update-initramfs -u

edit the following file:

nano /etc/default/grub

and add the following lines:



save and exit



when rebooted:

teamviewer setup

Finally, you should now be able to setup teamviewer:

Welcome to TeamViewer configuration 

blah blah blah

Accept Licence Agreement? (y/n)


Please enter your email/username: (enter your Teamviewer account email)

Please enter your password: (enter your Teamviewer account password)

Please check your inbox for the mail we sent you and follow the provided link.
We could not verify if your account has been used on this device before. To sign
in on this device you need to add it to your trusted devices.

Check your email and click the links to allow this machine.

Repeat entering username and password.

Adding this machine as '' to the group 'My Computers' of
your account My Name (NAME). Do you want to continue? (y/n) [n]  y

*** You have successfully added this computer to your Computers & Contacts. You
can now access it with a simple double click in your Computers & Contacts list.