Client Installation
Install the Telepresence client on your workstation by running the commands below for your OS.
Install using a package manager (Recommended)
The package installers set up the root daemon as a systemd service, eliminating the need for elevated privileges when using Telepresence.
Debian/Ubuntu (.deb)
# Download the latest .deb package
# AMD64
curl -fLO https://github.com/telepresenceio/telepresence/releases/latest/download/telepresence-linux-amd64.deb
# ARM64
curl -fLO https://github.com/telepresenceio/telepresence/releases/latest/download/telepresence-linux-arm64.deb
# Install the package
sudo apt install ./telepresence-linux-*.deb
Fedora/RHEL (.rpm)
# Download the latest .rpm package
# AMD64
curl -fLO https://github.com/telepresenceio/telepresence/releases/latest/download/telepresence-linux-amd64.rpm
# ARM64
curl -fLO https://github.com/telepresenceio/telepresence/releases/latest/download/telepresence-linux-arm64.rpm
# Install the package
sudo dnf install ./telepresence-linux-*.rpm
Viewing service logs
The root daemon service logs to the systemd journal:
journalctl -u telepresence-rootd
If you get a permission error, your user needs to be in a group that can read the journal.
On Fedora/RHEL, add yourself to the wheel group. On Debian/Ubuntu, use systemd-journal or adm:
sudo usermod -aG systemd-journal $USER
Log out and back in for the change to take effect.
OR download the binary manually
# 1. Download the latest binary (~95 MB):
# AMD64
sudo curl -fL https://github.com/telepresenceio/telepresence/releases/latest/download/telepresence-linux-amd64 -o /usr/local/bin/telepresence
# ARM64
sudo curl -fL https://github.com/telepresenceio/telepresence/releases/latest/download/telepresence-linux-arm64 -o /usr/local/bin/telepresence
# 2. Make the binary executable:
sudo chmod a+x /usr/local/bin/telepresence
Installing the standalone binary does not set up the root daemon as a system service. Telepresence will request elevated privileges when connecting.
What's Next? Follow one of our quick start guides to start using Telepresence, either with our sample app or in your own environment.
Uninstalling
Use your package manager to remove Telepresence:
# Debian/Ubuntu
sudo apt remove telepresence
# Fedora/RHEL
sudo dnf remove telepresence
This stops and removes the root daemon systemd service and the Telepresence binaries.
Installing older versions of Telepresence
Use these URLs to download an older version for your OS (including older nightly builds), replacing X.Y.Z with the version you want.
# AMD64
https://github.com/telepresenceio/telepresence/releases/download/vX.Y.Z/telepresence-linux-amd64
https://github.com/telepresenceio/telepresence/releases/download/vX.Y.Z/telepresence-linux-amd64.deb
https://github.com/telepresenceio/telepresence/releases/download/vX.Y.Z/telepresence-linux-amd64.rpm
# ARM64
https://github.com/telepresenceio/telepresence/releases/download/vX.Y.Z/telepresence-linux-arm64
https://github.com/telepresenceio/telepresence/releases/download/vX.Y.Z/telepresence-linux-arm64.deb
https://github.com/telepresenceio/telepresence/releases/download/vX.Y.Z/telepresence-linux-arm64.rpm