Scaling Privileged Access for Modern Infrastructure: Real-World Insights
Apr 25
Virtual
Register Today
Support
LOG IN
Teleport logoTry For Free
Contact SalesTry for Free
Support
LOG IN
Fork me on GitHub

Teleport

Uninstall Teleport

Version 15.x

This guide explains how to uninstall Teleport binaries completely.

Prerequisites

  • A system with Teleport installed.
Warning

These instructions only apply to non-containerized installations of Teleport.

If you are running Teleport in Kubernetes, you should uninstall the Helm chart release instead:

Example: uninstall the Helm release named 'teleport-kube-agent' in the 'teleport' namespace
helm uninstall --namespace teleport teleport-kube-agent

If you are running Teleport in Docker, you should stop the Teleport Docker container:

Example: Stop the Docker container named 'teleport'
docker stop teleport

Step 1/3. Stop any running Teleport processes

Instruct systemd to stop the Teleport process, and disable it from automatically starting:

sudo systemctl stop teleport
sudo systemctl disable teleport

If these systemd commands do not work, you can "kill" all the running Teleport processes instead:

sudo killall teleport

Instruct launchd to stop the Teleport process, and disable it from automatically starting:

sudo launchctl unload -w /Library/LaunchDaemons/com.goteleport.teleport.plist
sudo rm -f /Library/LaunchDaemons/com.goteleport.teleport.plist

If these commands do not work, you can "kill" all the running Teleport processes instead:

sudo killall teleport

There are currently no long-running Teleport processes on Windows machines.

Step 2/3. Remove Teleport binaries

Teleport Edition

Teleport Community Edition

Uninstall the Teleport binary using APT:

sudo apt-get -y remove teleport

Uninstall the Teleport APT repo:

sudo rm -f /etc/apt/sources.list.d/teleport.list
Uninstall standalone DEB package

If the commands above do not work, you may have installed Teleport using a standalone DEB package. Remove it with:

sudo dpkg -r teleport

Uninstall the Teleport binary using YUM:

sudo yum -y remove teleport
Optional: Use DNF on newer distributions
$ sudo dnf -y remove teleport

Uninstall the Teleport YUM repo:

sudo rm -f /etc/yum.repos.d/teleport.repo
Uninstall standalone RPM package

If the commands above do not work, you may have installed Teleport using a standalone RPM package. Remove it with:

sudo rpm -e teleport
Notice

These are the default paths to the Teleport binaries. If you have changed these from the defaults on your system, substitute those paths here. You can use dirname $(which teleport) to look this up automatically.

Remove the Teleport binaries from the machine:

sudo rm -f /usr/local/bin/tbot
sudo rm -f /usr/local/bin/tctl
sudo rm -f /usr/local/bin/teleport
sudo rm -f /usr/local/bin/tsh
Notice

These are the default paths to the Teleport binaries. If you have changed these from the defaults on your system, substitute those paths here. You can use dirname $(which teleport) to look this up automatically.

Remove the Teleport binaries from the machine:

sudo rm -f /usr/local/bin/tbot
sudo rm -f /usr/local/bin/tctl
sudo rm -f /usr/local/bin/teleport
sudo rm -f /usr/local/bin/tsh
Uninstall MacOS client tools

If you installed the MacOS tsh-only package and/or Teleport Connect for MacOS, you can optionally remove those too:

sudo rm -rf /Applications/tsh.app
sudo rm -rf /Applications/Teleport\ Connect.app

Remove the tsh.exe binary from the machine:

del C:\Path\To\tsh.exe

You can uninstall Teleport Connect from the "Apps and Features" section of the Control Panel.

For reference, Teleport Connect binaries are installed to %LOCALAPPDATA%\Programs\teleport-connect.

Uninstall the Teleport binary using APT:

sudo apt-get -y remove teleport-ent
Optional: If using the Teleport FIPS package
$ sudo apt-get -y remove teleport-ent-fips

Uninstall the Teleport APT repo:

sudo rm -f /etc/apt/sources.list.d/teleport.list
Uninstall standalone DEB package

If the commands above do not work, you may have installed Teleport using a standalone DEB package. Remove it with:

Enterprise
sudo dpkg -r teleport-ent
Enterprise FIPS
$ sudo dpkg -r teleport-ent-fips

Uninstall the Teleport binary using YUM:

sudo yum -y remove teleport-ent
Optional: Use DNF on newer distributions
$ sudo dnf -y remove teleport-ent
Optional: If using the Teleport FIPS package
$ sudo yum -y remove teleport-ent-fips
$ sudo dnf -y remove teleport-ent-fips

Uninstall the Teleport YUM repo:

sudo rm -f /etc/yum.repos.d/teleport.repo
Uninstall standalone RPM package

If the commands above do not work, you may have installed Teleport using a standalone RPM package. Remove it with:

Enterprise
sudo rpm -e teleport-ent
Enterprise FIPS
$ sudo rpm -e teleport-ent-fips
Notice

These are the default paths to the Teleport binaries. If you have changed these from the defaults on your system, substitute those paths here. You can use dirname $(which teleport) to look this up automatically.

Remove the Teleport binaries from the machine:

sudo rm -f /usr/local/bin/tbot
sudo rm -f /usr/local/bin/tctl
sudo rm -f /usr/local/bin/teleport
sudo rm -f /usr/local/bin/tsh
Notice

These are the default paths to the Teleport binaries. If you have changed these from the defaults on your system, substitute those paths here. You can use dirname $(which teleport) to look this up automatically.

Remove the Teleport binaries from the machine:

sudo rm -f /usr/local/bin/tbot
sudo rm -f /usr/local/bin/tctl
sudo rm -f /usr/local/bin/teleport
sudo rm -f /usr/local/bin/tsh
Uninstall MacOS client tools

If you installed the MacOS tsh client-only package and/or Teleport Connect for MacOS, you can optionally remove those too:

sudo rm -rf /Applications/tsh.app
sudo rm -rf /Applications/Teleport\ Connect.app

Remove the tsh.exe binary from the machine:

del C:\Path\To\tsh.exe

You can uninstall Teleport Connect from the "Apps and Features" section of the Control Panel.

For reference, Teleport Connect binaries are installed to %LOCALAPPDATA%\Programs\teleport-connect.

Uninstall the Teleport binary using APT:

sudo apt-get -y remove teleport-ent
NOTE: Older Teleport Enterprise Cloud users may be running Teleport Community Edition binaries instead
$ sudo apt-get -y remove teleport

Uninstall the Teleport APT repo:

sudo rm -f /etc/apt/sources.list.d/teleport.list
Uninstall standalone DEB package

If the commands above do not work, you may have installed Teleport using a standalone DEB package. Remove it with:

sudo dpkg -r teleport-ent
NOTE: Older Teleport Enterprise Cloud users may be running Teleport Community Edition binaries instead
$ sudo dpkg -r teleport

Uninstall the Teleport binary using YUM:

sudo yum -y remove teleport-ent
Optional: Use DNF on newer distributions
$ sudo dnf -y remove teleport-ent
NOTE: Older Teleport Enterprise Cloud users may be running Teleport Community Edition binaries instead
$ sudo yum -y remove teleport
$ sudo dnf -y remove teleport

Uninstall the Teleport YUM repo:

sudo rm -f /etc/yum.repos.d/teleport.repo
Uninstall standalone RPM package

If the commands above do not work, you may have installed Teleport using a standalone RPM package. Remove it with:

sudo rpm -e teleport-ent
NOTE: Older Teleport Enterprise Cloud users may be running Teleport Community Edition binaries instead
$ sudo rpm -e teleport
Notice

These are the default paths to the Teleport binaries. If you have changed these from the defaults on your system, substitute those paths here. You can use dirname $(which teleport) to look this up automatically.

Remove the Teleport binaries from the machine:

sudo rm -f /usr/local/bin/tbot
sudo rm -f /usr/local/bin/tctl
sudo rm -f /usr/local/bin/teleport
sudo rm -f /usr/local/bin/tsh
Notice

These are the default paths to the Teleport binaries. If you have changed these from the defaults on your system, substitute those paths here. You can use dirname $(which teleport) to look this up automatically.

Remove the Teleport binaries from the machine:

sudo rm -f /usr/local/bin/tbot
sudo rm -f /usr/local/bin/tctl
sudo rm -f /usr/local/bin/teleport
sudo rm -f /usr/local/bin/tsh
Uninstall MacOS client tools

If you installed the MacOS tsh client-only package and/or Teleport Connect for MacOS, you can optionally remove those too:

sudo rm -rf /Applications/tsh.app
sudo rm -rf /Applications/Teleport\ Connect.app

Remove the tsh.exe binary from the machine:

del C:\Path\To\tsh.exe

You can uninstall Teleport Connect from the "Apps and Features" section of the Control Panel.

For reference, Teleport Connect binaries are installed to %LOCALAPPDATA%\Programs\teleport-connect.

Step 3/3. Remove Teleport data and configuration files

Notice

These are the default paths to the Teleport config files and data directory. If you have changed these from the defaults on your system, substitute those paths here.

Remove the Teleport config file:

sudo rm -f /etc/teleport.yaml
Optional: Also remove the Machine ID config file, if you used it
$ sudo rm -f /etc/tbot.yaml

Remove the Teleport data directory:

sudo rm -rf /var/lib/teleport

Optionally, also remove the global config file and local user data directory for tsh:

sudo rm -f /etc/tsh.yaml
rm -rf ~/.tsh
Notice

These are the default paths to the Teleport config files and data directory. If you have changed these from the defaults on your system, substitute those paths here.

Remove the Teleport config file:

sudo rm -f /etc/teleport.yaml
Optional: Also remove the Machine ID config file, if you used it
$ sudo rm -f /etc/tbot.yaml

Remove the Teleport data directory:

sudo rm -rf /var/lib/teleport

Optionally, also remove:

  • the global config file and local user data directory for tsh
  • the local user data directory for Teleport Connect
tsh
sudo rm -f /etc/tsh.yaml
rm -rf ~/.tsh
Teleport Connect
rm -rf ~/Library/Application\ Support/Teleport\ Connect

Remove the local user data directory for tsh:

rmdir /s /q %USERPROFILE%\.tsh

Optionally, also remove the local user data directory for Teleport Connect:

rmdir /s /q "%APPDATA%\Teleport Connect"

Teleport is now removed from your system.

Any Teleport services will stop appearing in your Teleport Web UI or the output of tsh ls once their last heartbeat has timed out. This usually occurs within 10-15 minutes of stopping the Teleport process.