Uninstall Linux-Based Gateways and Relays
Last modified on October 4, 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.
- Log in to the server via a command-line interface.
- Stop the Gateway/Relay service with a command similar to the following:
sudo systemctl stop sdm-proxy
- Remove all StrongDM (
sdm) items, including the proxy configuration,
sdm-proxyservices, and related folders, as in the following example. We suggest running these commands with
sudoand 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
- Unset the
unset SDM_RELAY_TOKEN unset SDM_ADMIN_TOKEN
- Although it may not be necessary in your specific situation, we suggest that you reboot the server, to be thorough.