Uninstall Linux-Based Nodes

Last modified on April 16, 2024

Overview

This article provides the general process of uninstalling Linux-based nodes (gateways or relays). If you need to remove the StrongDM gateway or 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 StrongDM 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.