Linux Nodes

Last modified on April 22, 2024

Overview

This guide describes how to install a StrongDM node (gateway or relay) on Linux.

Steps

  1. Log in to the StrongDM Admin UI.
  2. Go to Network > Gateways and click Add gateway, or go to Network > Relays and click Add relay.
Add Gateway
Add Gateway
  1. For Name, enter a display name for the gateway or relay.

  2. For a gateway, for Advertised Host, define the advertised host for the server (for example, sdm-gw0.yourcompany.com, or 111.222.333.444). It must be an IP or hostname accessible to your StrongDM clients. Additionally, for Advertised Port, enter the port that you left open for the gateway to interact with StrongDM clients (by default, 5000).

  3. Click Create gateway or Create relay. A token is generated that is only shown to you one time that you’ll need to use later in the installation process. Carefully copy the token and save it somewhere for later use.

  4. Log in to the server you created to host your node.

  5. Download the StrongDM binary:

    curl -J -O -L https://app.strongdm.com/releases/cli/linux
    
  6. Unzip it (if this is a new server, you may need to install a package to unzip archives, such as with sudo apt-get install unzip on Ubuntu distributions):

    unzip sdmcli_VERSION_NUMBER_linux_amd64.zip
    
  7. Install the node:

    sudo ./sdm install --relay
    

    You will be prompted for the token you generated in the Admin UI; paste it in and hit enter. Note that the token won’t show in the terminal for security purposes, similar to the masking of a password.

  8. In the Admin UI, go back to Network > Gateways or Network > Relays to check the status of your node.

The node you created should appear to be online and have a heartbeat. If it doesn’t appear online, perform a hard refresh of your browser. Within a couple of minutes, if it is still not online, verify that the StrongDM daemon is running by running ps aux|grep sdm on the server and looking for a line that says sdm relay.