Uninstall Linux-Based Gateways and Relays

Last modified on March 24, 2023

This article provides the general process of uninstalling Linux-based Gateways or Relays. If you need to remove the StrongDM Gateway/Relay software from your server and do not intend to destroy the server itself, follow the instructions provided.

Steps

  1. Log in to the server via a command-line interface.
  2. Stop the Gateway/Relay service with a command similar to the following:
sudo systemctl stop sdm-proxy
  1. Remove all StrongDM (sdm) items, including the proxy configuration, sdm and sdm-proxy services, and related folders, as in the following example. We suggest running these commands with sudo and using the -f (force) flag to ensure that the items are entirely removed regardless of any potential permission issues.
sudo rm -f /etc/sysconfig/sdm-proxy
sudo rm -f /etc/systemd/system/sdm.service
sudo rm -f /etc/systemd/system/sdm-proxy.service
sudo rm -f /usr/local/bin/sdm
sudo rm -f /opt/strongdm/bin/sdm
  1. Unset the SDM_RELAY_TOKEN and SDM_ADMIN_TOKEN environment variables:
unset SDM_RELAY_TOKEN
unset SDM_ADMIN_TOKEN
  1. Although it may not be necessary in your specific situation, we suggest that you reboot the server, to be thorough.

If you have problems, please contact StrongDM Support.