How to Install TeamViewer on Ubuntu 26.04 – Complete Guide

Configure secure remote control access on your Ubuntu machine. Bypass modern Wayland session restrictions, setup headless terminal connections, and register automatic package updates.

TeamViewer Installation Methods Compared

Use the comparison table below to review features, package base, repository automation, and compatibility differences.

Note: TeamViewer does not maintain official packages on the Snap Store or Flathub. This guide focuses strictly on the official native DEB and APT repository installation paths.

You can temporarily switch your session to Xorg without modifying configuration files:

1. Save your work and log out of your current session.
2. On the login screen, click your username to display the password input.
3. Look at the bottom-right corner of the screen and click the **gear icon**.
4. Select **Ubuntu on Xorg** (or **Ubuntu on X11**) from the menu.
5. Enter your password and complete the login.

You can verify that your session type has switched to X11 by running this command in your terminal:

echo $XDG_SESSION_TYPE

Expected output: x11

If the machine needs to accept unattended connections regularly, you can disable Wayland globally:

1. Open the GDM3 display manager configuration file in terminal:

   sudo nano /etc/gdm3/custom.conf

2. Locate the line containing:

   #WaylandEnable=false

3. Uncomment the line by removing the leading hash character, changing it to:

   WaylandEnable=false

4. Save the changes and exit (press Ctrl+O, then Enter, then Ctrl+X).
5. Restart the GDM3 service to apply the change (note that this will end your current GUI session immediately):

   sudo systemctl restart gdm3

Connecting remotely to a headless Ubuntu machine (no physical monitor attached) requires configuring Xorg to render a virtual display. Without this configuration, you will experience a black screen even when Wayland is disabled.

Setting Unattended Access Password: You must configure a permanent remote connection password via the terminal command line interface:

sudo teamviewer passwd your_secure_password

Resolving Headless Black Screens: Connect a physical HDMI dummy plug to the graphics port of the server. This tricks the GPU into detecting an active display and hardware-accelerating the remote desktop session. Alternatively, configure a virtual frame buffer service (such as Xvfb) to allocate a software-rendered desktop environment.

Open a terminal session and update your local package list database to prevent conflict issues during the dependencies installation:

sudo apt update && sudo apt upgrade -y

Use the command line file downloader `wget` to fetch the installation package directly from the official TeamViewer download servers:

wget https://download.teamviewer.com/download/linux/teamviewer_amd64.deb

Install the downloaded package. We use `apt install` rather than `dpkg -i` because APT will automatically download and install required dependencies (such as libminizip1 or specific X11 libraries) from Ubuntu’s base repositories:

sudo apt install ./teamviewer_amd64.deb -y

Ensure the background service daemon is active and configured to start automatically when the system boots:

sudo systemctl enable teamviewerd.service
sudo systemctl start teamviewerd.service

Verify that the daemon is active without errors:

sudo systemctl status teamviewerd.service

Create the storage folder for local keys. Download TeamViewer’s GPG public security key, de-armor it so APT can read the binary format directly, and save it in `/usr/share/keyrings`:

sudo mkdir -p /usr/share/keyrings
curl -fsSL https://linux.teamviewer.com/pubkey/currentkey.asc | gpg --dearmor | sudo tee /usr/share/keyrings/teamviewer-keyring.gpg > /dev/null

Create a new repository configuration file named `teamviewer.sources` under the APT directory. Open the editor:

sudo nano /etc/apt/sources.list.d/teamviewer.sources

Paste the following structured key-value parameters into the configuration file:

Types: deb
URIs: https://linux.teamviewer.com/deb
Suites: stable
Components: main
Signed-By: /usr/share/keyrings/teamviewer-keyring.gpg

Save the file and exit the editor by pressing Ctrl+O, Enter, then Ctrl+X.

Update your APT cache to read the newly configured repository settings, then install the latest stable TeamViewer package version:

sudo apt update && sudo apt install teamviewer -y

Deactivate the background daemon to ensure no processes remain active in the system memory:

sudo systemctl stop teamviewerd.service
sudo systemctl disable teamviewerd.service

Purge the application files. Purging removes the package binaries and its system configuration settings files:

sudo apt purge teamviewer -y

Remove the repository files and security GPG keys to clean up your sources directory:

sudo rm -f /etc/apt/sources.list.d/teamviewer.list
sudo rm -f /etc/apt/sources.list.d/teamviewer.sources
sudo rm -f /usr/share/keyrings/teamviewer-keyring.gpg

Run system autoremove to clean up any leftover dependency libraries that are no longer required by other applications:

sudo apt autoremove --purge -y

Remove the leftover log files and custom configurations saved under your home directory:

rm -rf ~/.config/teamviewer
rm -rf ~/.local/share/teamviewer

Use the external resources below to access official community support and additional documentation files: