How to setup TeamViewer on Raspberry Pi

TeamViewer offers the one of the most effective and efficient Raspberry Pi remote control solution. Easy to download and easy to use, this allows for your Raspberry Pi device to be accessed remotely with TeamViewer 24/7, from anywhere in the world. Your Raspberry Pi allows you to solve problems that matter to you using the power of digital technology and computing. When combined with the TeamViewer solution, there’s no limit to what you and your imagination can come up with! Take advantage of the full potential of your Raspberry Pi by connecting to it remotely using TeamViewer.

To install TeamViewer on the Raspberry Pi, you will have to be utilizing a Raspberry Pi 2/3/4/zero

This means that the TeamViewer software should work for the vast majority of people unless you are running a now somewhat outdated version of the Raspberry Pi.

There are other methods of connecting to your Raspberry Pi remotely such as using VNC server. For pure terminal sharing you can use something like tmate.

  1. Raspberry Pi 2 or newer (2, 3, 3B+)
  2. 8GB SD Card or Micro SD Card if you’re using a Raspberry Pi 2, 3 or B+
  3. USB Keyboard
  4. USB Mouse
  5. HDMI Cable
  6. Ethernet Cord or Wifi dongle

Installing TeamViewer to the Raspberry Pi

1. To install TeamViewer to your Raspberry Pi, we will have first to ensure that our package list and all installed packages are up to date.

You can achieve this by running the following command.
sudo apt-get update
sudo apt-get upgrade

2. With the Raspberry Pi now entirely up to date. Let’s go ahead and download the software package from Teamviewer’s servers.

As we are already using the command line, we can do that by running the following command. This command will use wget to download the .deb file from TeamViewer’s server.

A .deb file is a package file designed for the Debian systems package management system. The .deb file is an archive containing all the files that we need for TeamViewer.

3. Now that we have the TeamViewer deb file available on our Raspberry Pi lets go ahead and install it by running the following command.

To install the TeamViewer deb package, we will be making use of the dpkg utility which is the base of the Debian package management software.

sudo dpkg -i teamviewer-host_armhf.deb

4. Upon running the above command, you will notice a bunch of errors about specific packages not being installed.

To fix this, we will have to make use of our package manager to repair the “broken install”.

The apt package manager will automatically detect the missing packages and attempt to download the best versions available for the software.

Now let’s utilize the apt tool by running the command below.

sudo apt --fix-broken install
5. TeamViewer should now be up and running on your Raspberry Pi. The software is automatically set up so that it will start up on boot, so you do not have to worry about that.

In the next two sections, we will explore utilizing TeamViewer on both a GUI setup and a headless setup.

With TeamViewer, you can access your Raspberry Pi even if you are running a lite version of Raspbian that only has the command line. TeamViewer is set up to share the command line screen as well. 

Using TeamViewer on a Headless Raspberry Pi Setup

1. Before you can access the Raspberry Pi from a TeamViewer client, we will first have to designate a password for the server.

We can do that by running the following command, where “” is the password that you want to utilize.

Make sure you keep this password secure as it will allow someone access to your Raspberry Pi if they manage to get your TeamViewer ID and its password.

sudo teamviewer passwd 

2. Now that we have set a password for TeamViewer on our Raspberry Pi let’s now go ahead and retrieve the TeamViewer ID.

The TeamViewer ID is the ID that you will utilize to make a connection to the TeamViewer server sitting on the Raspberry Pi.

To retrieve the TeamViewer ID type in the following command into the terminal.
teamviewer info

3. You will get a result from this command showing something like what we have below.

Where we have {xxxxxxxxxx} is where your TeamViewer ID will be, write this number down as you will need this to connect to your Raspberry Pi.
 TeamViewer                           14.2.2558  (DEB)

 TeamViewer ID:                        {xxxxxxxxxx}

4. Alternatively, if you want to be able to connect to your Raspberry Pi through TeamViewer easier, then you can connect your device up to your TeamViewer account.

To begin this process, run the following command.
sudo teamviewer setup
5. During the setup process, you will be asked to agree to the terms and conditions as well as enter the details of your TeamViewer account. Entering your account details is so that TeamViewer can make a connection to it and allow you to gain access to your account through the TeamViewer interface easily.

Once you have completed the setup process you should now be able to connect to your TeamViewer server running on your Raspberry Pi.

You can skip to the Using TeamViewer to connect to your Raspberry Pi section to see how you can connect to your Raspberry Pi’s installation of TeamViewer.

Using TeamViewer from the GUI on the Raspberry Pi

1. Upon installing TeamViewer to your Raspberry Pi, you will be greeted with the screen below asking you to accept TeamViewer’s license agreement.

To continue with this guide, you will need to click the Accept License Agreement button.

2. Once you have agreed to the license agreement, you will be returned to the desktop.To open up the Teamviewer host software click the TeamViewer icon in the taskbar as shown in the screenshot below.

3. In this screen, you need to decide whether you want to associate your Raspberry Pi with your TeamViewer account or to set a password and connect by using the TeamViewer ID.

If you want to rely on using the TeamViewer ID go ahead and click set a personal password. (1.) to load the options menu. If you select this option make sure you skip to step 5 of this tutorial.

If you decide to utilize your TeamViewer account to connect to your Raspberry Pi go ahead and click the Grant easy access (2.) button. If you select this, move on to step 4 of this tutorial.

4. If you have decided to connect your Raspberry Pi’s TeamViewer host to your TeamViewer account, you will now be asked to “Assign your account“.

This process will connect your device to your TeamViewer account allowing easy access. All you need to do is enter your Email as well as your Password (1.)

Once you have entered all your information, you need to click the Assign button (2.). Clicking the button will finalize the connection and associate the device.

Now you can move on to Step 6 of this Raspberry Pi Teamviewer tutorial.

5a. If you have decided to rely on using the TeamViewer ID, you will need to set a password.

Upon clicking “set a personal password.” in step 3, you will now be shown the TeamViewer options menu.

Within this menu click the “Security” tab as shown in the screenshot below.

5b. On this screen set your password under the Personal password (1.) section. Make sure you keep this secure as someone could gain access if they obtain it and your TeamViewer ID.

Once you have set your password, press the Apply button.

5c. Once you have set your TeamViewer personal access password, you should now be greeted by the default TeamViewer interface as shown below.

Here you will be shown your TeamViewer ID, using this ID and the password you will be able to connect to your Raspberry Pi by utilizing the TeamViewer software.

Using TeamViewer to Connect to your Raspberry Pi

1. With TeamViewer now set up on your Raspberry Pi we can now move onto connecting to it.

To connect to it, you will require a device with the TeamViewer client installed, whether it be a Windows PC or most other devices.

You can download TeamViewer by going to the TeamViewer website. Once installed continue to the next step.

2. Now with TeamViewer loaded you will be able to either enter the TeamViewer ID (2.) and connect to your Raspberry Pi that way.

Or if you connected your Raspberry Pi to your TeamViewer account, you will be able to double-click it in your connections list to connect to the device.

3. Once you have connected to your Raspberry Pi using TeamViewer, you will be greeted by either your desktop or the command line depending on what version of Raspbian you are utilizing.

If everything connected properly, then you have now successfully set up TeamViewer on your Raspberry Pi.

By now you should have everything working perfectly. If you have any feedback on this Raspberry Pi Teamviewer tutorial, then please don’t hesitate to leave a comment below.