Yes, you can install TeamViewer on Linux, and this guide shows you the exact steps for Debian/Ubuntu, Fedora, and Arch-based systems, plus how to set up unattended access and troubleshoot common issues. TeamViewer provides remote desktop control, file transfer, and online meetings, and it works on most Linux distributions with a graphical interface.
What TeamViewer Does on Linux
TeamViewer is a remote desktop application that lets you view and control another computer over the internet as if you were sitting in front of it. On Linux, the software runs as a native application (not a web app) and supports both incoming and outgoing connections. You can use it to help a friend fix their system, access your home machine from work, or collaborate on a project. The Linux version includes the same core features as the Windows and macOS versions: remote control, file transfer, chat, and meeting scheduling. It also supports Wayland and X11 display servers, though Wayland has some limitations with input sharing, which we will cover later.
System Requirements and Prerequisites
Before installing, check that your system meets the minimum requirements. TeamViewer for Linux requires a 64-bit processor and at least 1 GB of RAM, though 2 GB is recommended for smooth performance. It needs about 250 MB of disk space. Your distribution must support either the DEB (Debian/Ubuntu) or RPM (Fedora/RHEL) package format, or you can use the generic tar.gz archive. You also need a graphical desktop environment—TeamViewer will not run on a headless server without additional configuration. For the best experience, ensure your system is up to date with the latest security patches and that you have sudo or root access to install packages.
Installation Methods by Distribution
TeamViewer provides official packages for major distributions. The easiest way is to download the package from the official website, but you can also use your package manager if the repository is configured. Here are the steps for the most common families:
Debian and Ubuntu (and Mint, Pop!_OS)
- Download the .deb file from the official TeamViewer download page (choose “Debian/Ubuntu” version).
- Open a terminal and navigate to your Downloads folder:
cd ~/Downloads - Install the package with
sudo apt install ./teamviewer_amd64.deb(the filename may vary). This will also install any required dependencies. - If you get a dependency error, run
sudo apt --fix-broken installand then retry.
Fedora and RHEL-based
- Download the .rpm file from the official site (choose “Red Hat / CentOS / Fedora” version).
- Open a terminal in the Downloads folder:
cd ~/Downloads - Run
sudo dnf install ./teamviewer.x86_64.rpm(or useyumon older RHEL). - If you encounter a GPG key error, you may need to import the key with
sudo rpm --import https://keys.teamviewer.com/TeamViewer.ascand then retry.
Arch and Manjaro
- You can install from the AUR (Arch User Repository) using an AUR helper like
yay:yay -S teamviewer. - Or manually clone the AUR package and build it with
makepkg -si. - After installation, enable the daemon with
sudo systemctl enable teamviewerd.serviceand start it withsudo systemctl start teamviewerd.service.
After installation, you can launch TeamViewer from the application menu or by typing teamviewer in the terminal. The first launch will ask you to accept the license agreement and may prompt for a password to set up unattended access.
Setting Up Unattended Access
Unattended access allows you to connect to this Linux machine without someone accepting the connection on the other end. This is useful for remote administration. To set it up:
- Launch TeamViewer and note the “Your ID” shown in the main window.
- Click on “Set up unattended access” in the “Remote Control” tab.
- Enter a name for this computer (e.g., “Home Server”) and set a strong password. This password is separate from your TeamViewer account password.
- You can also assign the device to your TeamViewer account for easier management. To do this, sign in with your account credentials and the device will appear in your “Computers & Contacts” list.
Once configured, you can connect from any other device by entering the ID and password. For security, use a unique, long password and enable two-factor authentication on your TeamViewer account if you plan to access sensitive systems.
Using TeamViewer for Remote Control and File Transfer
To control a remote Linux machine, open TeamViewer, enter the remote computer’s ID in the “Partner ID” field, and click “Connect”. You will be prompted for the password (either the unattended password or the one shown on the remote screen). After connecting, you can:
- Move the mouse and type as if you were at the remote machine.
- Transfer files by clicking “File Transfer” in the top menu. This opens a dual-pane interface where you can drag and drop files between local and remote systems.
- Use the “Chat” feature to communicate with the remote user.
For best performance, use a wired network connection or a strong Wi-Fi signal. You can adjust the quality settings in the connection bar to balance speed and visual clarity. If the remote screen appears black or frozen, try switching the display server to X11 (if using Wayland) or restarting the TeamViewer daemon.
Common Problems and Fixes
Here are the most frequent issues users encounter and how to resolve them:
- TeamViewer won’t start – Check if the daemon is running:
sudo systemctl status teamviewerd. If not, start it withsudo systemctl start teamviewerd. Also verify that the package is fully installed withdpkg -l | grep teamviewer(Debian) orrpm -qa | grep teamviewer(RPM). - Can’t connect to a Windows machine – Ensure the Windows machine has TeamViewer running and the correct password. If the connection times out, check your firewall settings. On Linux, allow TCP port 5938:
sudo ufw allow 5938(if using UFW). - Wayland issues – On Wayland, TeamViewer may not be able to share input or see the screen correctly. Log out and select “GNOME on Xorg” (or your desktop’s X11 session) at the login screen to use X11 instead.
- Audio not working – TeamViewer supports audio on Linux, but you may need to install the PulseAudio or PipeWire package. Ensure your system has a working audio server.
- Package dependency errors – On Debian/Ubuntu, run
sudo apt --fix-broken installto resolve missing dependencies. On Fedora,sudo dnf install --allowerasingmay help.
Security Considerations
Remote access tools are a common target for attackers. To use TeamViewer safely on Linux:
- Always use a strong, unique password for unattended access. Avoid using the same password as your user account.
- Enable two-factor authentication (2FA) on your TeamViewer account. This adds an extra layer of protection even if your password is compromised.
- Keep TeamViewer updated. The software automatically checks for updates, but you can manually run
sudo apt update && sudo apt upgrade(Debian) orsudo dnf update(Fedora) to get the latest security patches. - Only accept incoming connections from people you trust. Be wary of unsolicited connection requests, as they may be phishing attempts.
- If you don’t need incoming connections, you can disable the daemon with
sudo systemctl disable teamviewerdand start it manually when needed.
Alternatives to TeamViewer
While TeamViewer is popular, there are open-source alternatives that work well on Linux:
- RustDesk – A free, open-source remote desktop tool that supports self-hosting. It offers similar features to TeamViewer and is available for Linux, Windows, and macOS.
- AnyDesk – A proprietary alternative with a lightweight client. It has a free tier for personal use and supports Linux.
- VNC (Virtual Network Computing) – A classic protocol that works with Linux’s built-in screen sharing. Tools like TigerVNC or RealVNC provide remote access, but they are less user-friendly for beginners.
- SSH with X11 forwarding – For command-line tasks, SSH is the most secure option. You can forward graphical applications with
ssh -X user@host, but it’s not a full remote desktop.
Each alternative has its strengths. RustDesk is ideal for those who want full control over their data, while AnyDesk offers a simpler interface. VNC is a good choice for local network use. TeamViewer remains a solid choice due to its ease of use and cross-platform support.
Frequently Asked Questions
Is TeamViewer free for Linux?
Yes, TeamViewer is free for personal, non-commercial use. For business use, you need a paid license. The free version includes all core features but may have session time limits for commercial use. You can check the official pricing page for details.
Can I use TeamViewer on a headless Linux server?
Yes, but you need to install a minimal desktop environment (like Xfce) and configure the display. TeamViewer requires a graphical session to run. You can set up unattended access and connect without a monitor, but the server must have a GPU or virtual display.
Why does TeamViewer show a black screen on my Linux machine?
This usually happens when using Wayland. Switch to X11 as your display server. If you’re on a laptop with hybrid graphics, try launching TeamViewer with the discrete GPU. Also, check that your desktop environment is not using a compositor that blocks screen capture.
How do I uninstall TeamViewer from Linux?
Use your package manager. On Debian/Ubuntu: sudo apt remove teamviewer. On Fedora: sudo dnf remove teamviewer. On Arch: sudo pacman -R teamviewer. This will remove the software but may leave configuration files in ~/.config/teamviewer and /etc/teamviewer.
Can I run TeamViewer on a Raspberry Pi?
Yes, TeamViewer provides a version for ARM devices like the Raspberry Pi. Download the appropriate package from the official site (armhf or arm64) and install it with your package manager. Performance may be slower than on a desktop, but it works for basic remote access.
Does TeamViewer work with Wayland?
TeamViewer has partial Wayland support. It can display the remote screen, but input sharing (mouse and keyboard) may not work correctly. For full functionality, switch to an X11 session. Some distributions like Fedora allow you to choose X11 at the login screen.
Related
General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.
More in this bed
- iOS 18 Safari Not Working? Fixes That Help
- How to Check Your Linux Kernel for Spectre
- iPhone Safe Mode: How to Enable or Disable It
- Fix Slow Internet Lag on Samsung Galaxy Note
- How to Get iOS 17 on iPhone X (Safe Methods)
- Fix Gmail IMAP Error in Outlook: Step-by-Step