Uninstall Linux-Based Gateways and Relays
Last modified on March 24, 2023
On this page
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
- 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
andsdm-proxy
services, and related folders, as in the following example. We suggest running these commands withsudo
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
- Unset the
SDM_RELAY_TOKEN
andSDM_ADMIN_TOKEN
environment variables:
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.
If you have problems, please contact StrongDM Support.