Close
logodocs

Mac Installation Guide

This guide provides information about installing the strongDM client on your Mac. The client consists of a graphical user interface (GUI) and a command line interface (CLI) utility.

Install the Client

  1. Open the invitation email you received for your strongDM account.

  2. Click the link enclosed in the email to set your password.

  3. Log in to strongDM and download the Mac client from the Download & Install section. You can also download the client directly. The file name appears as SDM-version_number.dmg.

    If you are using Homebrew, you can install the strongDM client using brew install sdm. To uninstall run brew uninstall sdm and remove the sdm folder with brew uninstall sdm --zap.

  4. To install the client, double click the downloaded .DMG file.

  5. Drag the SDM app to the Applications folder using the provided shortcut. If you do not have admin rights on your Mac, you can copy the SDM app to the Applications folder in your home directory or the Desktop, where it runs and updates normally without requiring admin privileges.

    SDM Installation Shortcut
    SDM Installation Shortcut

    Do not run SDM directly from the .DMG file. This results in degraded functionality.

Launch the GUI

  1. To launch the application, double click the SDM icon in your list of applications.

  2. The sdm icon appears in the menu bar. Click this icon to log in.

  3. Enter the email and password created during the email invitation step. You may also be redirected to your single sign-on provider instead.

  4. After logging in, a list of resources you have permission to access appears in the GUI.

    SDM Resources
    SDM Resources
  5. Click one of these resources to enable a connection and gain access. A green lightning bolt icon appears next to the connected resource.

  6. You may now connect to the resource on your machine using your preferred tool. When prompted for connection information, use localhost for the hostname/IP, leave the username and password blank, and specify the port listed next to the resource in the strongDM GUI. If the connection fails using these defaults, check the Connect to Resources section for more information.

    If you click a website resource, it launches in your default browser. To disconnect from any resource, click the named instance in the GUI and the green connection icon disappears. Any existing connections from your local machine to the resource are immediately disabled.

Set up the CLI

  1. After installing the SDM application, click the sdm icon in the menu bar. Make sure you are logged in by checking that the SDM application is online and your available resources display.

  2. Open the strongDM menu and click install 'sdm' in PATH.

    SDM Menu
    SDM Menu

    You can also open a terminal and type sudo ln -s /Applications/SDM.app/Contents/Resources/sdm.darwin /usr/local/bin/sdm. Either of these options links the sdm command line application into your PATH. To verify that it is working properly, type:

    $ sdm --version
    sdm-cli version 32.96.0 (3ce787f5b438303ad78cc4907f1d81bc9ec09945 #296)

    If instead you see something like -bash: sdm: command not found, it may mean that the path /usr/local/bin/ is not included in your system search path. Edit the shell configuration file your system is using. On a Mac, that is sometimes .bash_profile, but since macOS Catalina zsh is the default shell. Open the shell configuration file and append export PATH=/usr/local/bin/:$PATH to it. Then run:

    $ source ~/.zshrc
    $ sdm --version
    sdm-cli version 32.96.0 (3ce787f5b438303ad78cc4907f1d81bc9ec09945 #296)

If any errors occur or if the installation fails in any way, please contact support@strongdm.com for assistance.

User Guide — Previous
strongDM Binary Verification
Next
Windows Installation Guide